Troubleshooting

500 or blank page after install

• Check the PHP version and required extensions.
• Make sure require_once runs before HTML output and points to /antibot/index.php.
• Verify web-server write permissions for logs/, cache/, and lists/.
• Temporarily enable debug and inspect logs/antibot.log.

All visitors have the same IP

This usually means the site is behind a proxy/CDN without header_proxy. Configure X-Real-IP or Cloudflare headers before cleaning incorrect blocks.

[header_proxy]
enabled = On
header_ip = X-Real-IP
header_protocol = X-Forwarded-Proto

Captcha appears too often

• Check whitelist_url for API, REST, XML, callback, and health-check URLs.
• Use CAPTCHA instead of BLOCK for uncertain checks.
• Find RayID in logs/antibot.log and identify the exact filter.
• Prefer precise exceptions over disabling a whole filter.

False block

Ask for RayID and IP from the block page, find the log entry, remove the IP from blacklist_ip, or add a narrow whitelist_* exception.