canasta crowdsec bouncer-enroll
canasta > crowdsec > bouncer-enroll
canasta crowdsec bouncer-enroll
Register the Caddy bouncer with the CrowdSec engine
Synopsis
Register the Caddy bouncer with the running CrowdSec engine, store the generated API key as CROWDSEC_BOUNCER_API_KEY, and restart so the bouncer begins enforcing decisions.
Enabling CrowdSec (canasta config set CANASTA_ENABLE_CROWDSEC=true) now enrolls the bouncer automatically on the next start, so you rarely need to run this by hand. It is idempotent: if the bouncer is already enrolled and a key is stored, it reports success and does nothing. Use --force to revoke the existing bouncer and issue a fresh key (e.g. to rotate a key, or recover one that drifted out of sync). Distinct from console-enroll, which connects the engine to the cloud CrowdSec Console.
canasta crowdsec bouncer-enroll [flags]
Examples
canasta crowdsec bouncer-enroll
canasta crowdsec bouncer-enroll -i mysite
canasta crowdsec bouncer-enroll -i mysite --force
Flags
| Flag | Shorthand | Description | Default | Required | Orchestrator |
|---|---|---|---|---|---|
--force |
-f |
Revoke the existing bouncer and issue a fresh key | Both | ||
--id |
-i |
Canasta instance ID | * | Both |
* Defaults to the Canasta instance matching the current directory, if any.
Global flags
| Flag | Shorthand | Description | Default | Required | Orchestrator |
|---|---|---|---|---|---|
--help |
-h |
Show help message and exit | Both | ||
--verbose |
-v |
Enable verbose output | Both |