Getting Started | ZeroBot Docs

Introduction

ZeroBot is an advanced anti-bot solution that shields websites from unwanted automated traffic, offering robust, real-time detection and prevention capabilities powered by AI-driven fingerprinting.

Its flexible integration makes it ideal for websites, SaaS platforms, and marketing systems that need reliable protection and accurate traffic analytics.

About

Built for simplicity and efficiency, ZeroBot uses behavioral detection, ASN filtering, and device fingerprinting to block bots while allowing real human visitors to pass through seamlessly.

With its easy configuration and strong security layer, ZeroBot helps you maintain valid traffic analytics, protect your ad budgets, and optimize site performance.

How ZeroBot Works — One Engine, Different Roles

ZeroBot is built around a single anti-bot engine.
That same detection engine powers four different tools, and each tool applies it in a different role.
Before you start, it's important to understand which tools run on your own hosting and which ones run on ZeroBot's infrastructure.

The Antibot plan does not include hosting.
Your subscription gives you the ZeroBot script, API access, and the dashboard — you upload the script to your own hosting (cPanel, Plesk, VPS, or any PHP host).
ZeroBot does not host your website or store the script for you.
If you would rather we host the script for you, that is a separate service — see Private Hosting below.

Tool	Where it runs	What you do
You host it — runs on your own hosting
`Antibot`	Your own hosting	You upload `ZeroBot.php` to your web root and point a Custom Rule at it.
`Link Shortener`	Your own hosting	You upload the shortener package to your server, then generate keys from the dashboard.
ZeroBot hosts it — runs on our cloud
`Redirect Generator`	ZeroBot's cloud (Cloudflare)	Nothing to upload — you generate the protected link from the dashboard and use it directly.
`Private Hosting`	ZeroBot's cloud	Nothing to upload to your own server — you host your landing page with us, protection built in.

Why the split?
The engine is the same everywhere — the difference is where the protection runs.
Antibot and the Link Shortener run on your own hosting, giving you full control over your files and infrastructure.
Redirect Generator and Private Hosting run on ZeroBot's cloud, for when you don't want to manage a server at all.
Pick the tool that matches how much you want to host yourself — the bot detection is identical in every case.

Setup Guide

Quick Setup in 3 Minutes

1

Download your ZeroBot file

From your dashboard, download ZeroBot.php to your computer.

2

Open the file

Right-click the file and open with Notepad or VS Code.

3

Paste your license key

Find this line and replace with the key from your dashboard:

$license_key = "YOUR_LICENSE_KEY";

4

Save the file

Press Ctrl + S and close the editor.

5

Authorize your domain

Before uploading, go to Dashboard → My Domains and add the domain where you will deploy the script:

example.com

This is required — the API will reject requests from unauthorized domains. Learn more →

6

Upload to your website

Upload ZeroBot.php to your hosting — it can live in your web root or any subfolder you choose. Just point your rule's Antibot Link to wherever you put it:

cPanel: public_html Plesk: httpdocs …or any subfolder you choose

7

Open the file in browser

Visit your file to verify it's active:

https://yourdomain.com/ZeroBot.php

8

Create your first rule

Open ZeroBot Dashboard → Custom Rules and set:

Antibot Link → ZeroBot.php
Redirect Link → your landing page

9

Enable protection

Turn ON the protections you need:

VPN Block Datacenter Block Fingerprint

You're protected! From now on, all visitors go through ZeroBot automatically.

You never edit the file again. All changes are done from the dashboard.

Once uploaded, all protection settings such as VPN blocking, cloaking, countries, devices, captcha, and redirects are managed from ZeroBot Dashboard → Custom Rules.

Make sure you do not keep both index.html and index.php in the same directory — the HTML file will override the ZeroBot script.

Next: Configure Custom Rules

After uploading the ZeroBot script, you need to create a Custom Rule from the dashboard to activate protection. Custom Rules define how traffic is filtered, what gets blocked, and where visitors are redirected.

For the full configuration reference including all settings (VPN blocking, fingerprinting, cloaking, captcha, country/device restrictions, and more), see the dedicated guide:

View Custom Rules Guide

Important

Once the setup is complete, make sure your Custom Rules are properly configured in the ZeroBot dashboard. All protection settings including captcha, blocking, cloaking, and branding are managed directly from the Custom Rules page.

Thank You

Thank you for choosing ZeroBot — we appreciate your trust and commitment to secure, intelligent, and optimized web traffic management.

Need help? Our support team is always ready to assist via Telegram or the ZeroBot dashboard chat.

ZeroBot Documentation