BOTSTOPPER FROM TECHAROPRODUCT DOCUMENTATION

Configuration

Docker compose

Use the upstream Docker compose directions with the following additional options:

   anubis:
     image: ghcr.io/techarohq/botstopper/anubis:latest
     environment:
       BIND: ":8080"
       DIFFICULTY: "4"
       METRICS_BIND: ":9090"
       SERVE_ROBOTS_TXT: "true"
       TARGET: "http://nginx"
       OG_PASSTHROUGH: "true"
       OG_EXPIRY_TIME: "24h"

+      # botstopper config here
+      CHALLENGE_TITLE: "Doing math for your connnection!"
+      ERROR_TITLE: "Something went wrong!"
+      OVERLAY_FOLDER: /assets
+    volumes:
+      - "./your_folder:/assets"

Example

There is an example in docker-compose.yaml. Start the example with docker compose up:

docker compose up -d

And then open https://botstopper.local.cetacean.club:8443 in your browser.

NOTE: This uses locally signed sacrificial TLS certificates stored in ./demo/pki. Your browser will rightly reject these. Here is what the example looks like:

See customization for overlay folders and message titles. See headless browser detection and custom challenge methods for challenge configuration.

PREVIOUS← Custom challenge methods NEXTCustomization →