Quick Start
Shortest path to a running CrowdSec Manager
Quick Start
For full details and all configuration options, see Installation.
Which variant?
- Pangolin — you want the full integrated stack with Traefik, Pangolin, and Gerbil, and you are building from the repository.
- Independent — you want a standalone CrowdSec manager with no Traefik integration, using the pre-built image.
Pangolin
git clone https://github.com/hhftechnology/crowdsec_manager.git
cd crowdsec_manager
mkdir -p ./config/crowdsec ./config/traefik ./backups ./logs/app ./logs/traefik ./data
docker compose up -d
curl http://localhost:8080/api/health/stackThe default docker-compose.yml in the repo starts the full stack (crowdsec-manager, crowdsec, traefik, pangolin, gerbil).
Independent
mkdir -p ./config/crowdsec ./logs/app ./dataCreate docker-compose.yml:
services:
crowdsec-manager:
image: hhftechnology/crowdsec-manager:independent
container_name: crowdsec-manager
restart: unless-stopped
ports:
- "8080:8080"
environment:
- PORT=8080
- ENVIRONMENT=production
- LOG_LEVEL=info
- LOG_FILE=/app/logs/crowdsec-manager.log
- DOCKER_HOST=unix:///var/run/docker.sock
- CONFIG_DIR=/app/config
- DATABASE_PATH=/app/data/settings.db
- INCLUDE_CROWDSEC=true
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./config:/app/config
- ./logs/app:/app/logs
- ./data:/app/data
networks:
- crowdsec-network
depends_on:
- crowdsec
crowdsec:
image: crowdsecurity/crowdsec:latest
container_name: crowdsec
restart: unless-stopped
environment:
- GID=${GID:-1000}
- COLLECTIONS=crowdsecurity/linux
volumes:
- ./config/crowdsec/acquis.yaml:/etc/crowdsec/acquis.yaml:ro
- crowdsec-db:/var/lib/crowdsec/data/
- crowdsec-config:/etc/crowdsec/
networks:
- crowdsec-network
networks:
crowdsec-network:
driver: bridge
volumes:
crowdsec-db:
crowdsec-config:docker compose up -d
curl http://localhost:8080/api/health/stackOpen the UI at http://localhost:8080.