Files
Charon/docs/crowdsec-auto-start-quickref.md
akanealw eec8c28fb3
Some checks are pending
Go Benchmark / Performance Regression Check (push) Waiting to run
Cerberus Integration / Cerberus Security Stack Integration (push) Waiting to run
Upload Coverage to Codecov / Backend Codecov Upload (push) Waiting to run
Upload Coverage to Codecov / Frontend Codecov Upload (push) Waiting to run
CodeQL - Analyze / CodeQL analysis (go) (push) Waiting to run
CodeQL - Analyze / CodeQL analysis (javascript-typescript) (push) Waiting to run
CrowdSec Integration / CrowdSec Bouncer Integration (push) Waiting to run
Docker Build, Publish & Test / build-and-push (push) Waiting to run
Docker Build, Publish & Test / Security Scan PR Image (push) Blocked by required conditions
Quality Checks / Auth Route Protection Contract (push) Waiting to run
Quality Checks / Codecov Trigger/Comment Parity Guard (push) Waiting to run
Quality Checks / Backend (Go) (push) Waiting to run
Quality Checks / Frontend (React) (push) Waiting to run
Rate Limit integration / Rate Limiting Integration (push) Waiting to run
Security Scan (PR) / Trivy Binary Scan (push) Waiting to run
Supply Chain Verification (PR) / Verify Supply Chain (push) Waiting to run
WAF integration / Coraza WAF Integration (push) Waiting to run
changed perms
2026-04-22 18:19:14 +00:00

1.6 KiB
Executable File

CrowdSec Auto-Start - Quick Reference

Version: v0.9.0+ Last Updated: December 23, 2025


🚀 What's New

CrowdSec now automatically starts when the container restarts (if it was previously enabled).


Verification (One Command)

docker exec charon cscli lapi status

Expected: ✓ You can successfully interact with Local API (LAPI)


🔧 Enable CrowdSec

  1. Open Security dashboard
  2. Toggle CrowdSec ON
  3. Wait 10-15 seconds

Done! CrowdSec will auto-start on future restarts.


🔄 After Container Restart

docker restart charon
sleep 15
docker exec charon cscli lapi status

If working: CrowdSec shows "Active" If not working: See troubleshooting below


⚠️ Troubleshooting (3 Steps)

1. Check Logs

docker logs charon 2>&1 | grep "CrowdSec reconciliation"

2. Check Mode

docker exec charon sqlite3 /app/data/charon.db \
  "SELECT crowdsec_mode FROM security_configs LIMIT 1;"

Expected: local

3. Manual Start

curl -X POST http://localhost:8080/api/v1/admin/crowdsec/start

📖 Full Documentation


🆘 Get Help

GitHub Issues: Report Problems


Quick reference for v0.9.0+ CrowdSec auto-start behavior