# verifyngo

> An anti-AI and automated web traffic management system compatible with the Tor browser, legacy clients, and features options for self hosted captcha systems for maximum privacy.

- [verifyngo](https://verifyngo.chocolatemoo53.com/introduction.md): A simple bot blocking service
- [verifyngo quickstart: Docker setup](https://verifyngo.chocolatemoo53.com/quickstart.md): Run verifyngo as a reverse-proxy bot filter in front of your web service using Docker and a config.json file. No changes to your app are required.
- [Core config.json fields](https://verifyngo.chocolatemoo53.com/configuration/core.md): Configure listen address, upstream URL, cookie settings, trusted proxies, whitelist, default action, and path bypass rules in config.json.
- [CAPTCHA provider configuration](https://verifyngo.chocolatemoo53.com/configuration/captcha-providers.md): Use a captcha option for verifyngo and even configure multiple providers, so visitors can switch between them.
- [Traffic rules: allow, challenge, or deny incoming requests](https://verifyngo.chocolatemoo53.com/configuration/rules.md): Define rules in config.json, a plain-text file, or a YAML policy to allow, challenge, or deny traffic based on path, user agent, or IP address.
- [Define advanced traffic rules with YAML](https://verifyngo.chocolatemoo53.com/configuration/policy.md): Use a YAML policy file to define named network groups from ASNs, CIDRs, or remote URLs and write flexible, expressive per-rule conditions.
- [Progressive challenge mode](https://verifyngo.chocolatemoo53.com/configuration/progressive.md): Enable progressive mode to let new visitors browse freely for a configurable number of requests before a CAPTCHA challenge appears.
- [Persist ban and walk-away state across process restarts](https://verifyngo.chocolatemoo53.com/configuration/persistence.md): Configure verifyngo to store ban lists and walk-away counters in memory, a JSON file, or Redis so state survives restarts and scales across instances.
- [Customise the challenge page look and feel](https://verifyngo.chocolatemoo53.com/configuration/branding.md): Change the logo, colours, font, and the text shown on the CAPTCHA challenge page so it matches your website brand and feels familiar.
- [Automatic CSP](https://verifyngo.chocolatemoo53.com/configuration/automatic-cap.md)
- [Tarpit](https://verifyngo.chocolatemoo53.com/untitled-page.md): Posion AI scaping data with tarpit, making random garabage data for you.
- [Using verifyngo with Docker](https://verifyngo.chocolatemoo53.com/guides/docker.md): Run verifyngo in Docker using docker run or Docker Compose. Covers config file mounting, persistent state storage, and static file serving.
- [Put verifyngo behind a reverse proxy: Nginx, Caddy, Traefik](https://verifyngo.chocolatemoo53.com/guides/reverse-proxy.md): Set up Nginx, Caddy, or Traefik to send all traffic to verifyngo first, so bot filtering runs before requests reach your upstream app.
- [Filter traffic by ASN with whois or GeoLite2](https://verifyngo.chocolatemoo53.com/guides/asn-lookup.md): Use RADb whois lookups or a MaxMind GeoLite2 ASN database to expand ASN numbers into IP prefixes that policy rules can match against.
- [Report abusive IPs to AbuseIPDB](https://verifyngo.chocolatemoo53.com/guides/abuseipdb.md): Set up verifyngo to report IP addresses to AbuseIPDB automatically once they reach a configurable ban count, with a 15-minute cooldown.
- [verifyngo config.json: all fields, types, and defaults](https://verifyngo.chocolatemoo53.com/reference/config-options.md): Every field accepted by verifyngo's config.json, with types, default values, and plain-English descriptions of what each setting does.
- [Troubleshooting verifyngo](https://verifyngo.chocolatemoo53.com/reference/troubleshooting.md): Step-by-step fixes for common verifyngo problems including wrong IP detection, CAPTCHA verification failures, rules not reloading, and ban issues.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.