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
87 lines
1.6 KiB
Markdown
Executable File
87 lines
1.6 KiB
Markdown
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)
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
docker logs charon 2>&1 | grep "CrowdSec reconciliation"
|
|
```
|
|
|
|
### 2. Check Mode
|
|
|
|
```bash
|
|
docker exec charon sqlite3 /app/data/charon.db \
|
|
"SELECT crowdsec_mode FROM security_configs LIMIT 1;"
|
|
```
|
|
|
|
**Expected:** `local`
|
|
|
|
### 3. Manual Start
|
|
|
|
```bash
|
|
curl -X POST http://localhost:8080/api/v1/admin/crowdsec/start
|
|
```
|
|
|
|
---
|
|
|
|
## 📖 Full Documentation
|
|
|
|
- **Implementation Details:** [crowdsec_startup_fix_COMPLETE.md](implementation/crowdsec_startup_fix_COMPLETE.md)
|
|
- **Migration Guide:** [migration-guide-crowdsec-auto-start.md](migration-guide-crowdsec-auto-start.md)
|
|
- **User Guide:** [getting-started.md](getting-started.md#step-15-database-migrations-if-upgrading)
|
|
|
|
---
|
|
|
|
## 🆘 Get Help
|
|
|
|
**GitHub Issues:** [Report Problems](https://github.com/Wikid82/charon/issues)
|
|
|
|
---
|
|
|
|
*Quick reference for v0.9.0+ CrowdSec auto-start behavior*
|