Stable · v2.3.4

CrowdSec Manager

Web and mobile interface for managing CrowdSec — decisions, alerts, scenarios, hub, logs, backups, and Traefik integration.

Get Started Quick Start GitHub Discord

Mobile App

Native iOS and Android app — Pangolin and Basis connection modes supported.

Mobile app setup guide →

Dashboard

Health, alerts, metrics, and blocked IP activity at a glance

Decisions & Alerts

Full analysis, history, repeated offenders, and bulk reapply

Hub & Scenarios

Install, remove, and configure CrowdSec hub items and custom scenarios

Logs & Backups

Live log streaming, Traefik analysis, config validation, and backup management

Deployment Variants

Pangolinfull stack

Full guide →

Traefik + Pangolin + Gerbil + CrowdSec. Builds from source. Includes backup management and Traefik integration.

services:
  crowdsec-manager:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: crowdsec-manager
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - ENVIRONMENT=production
      - COMPOSE_FILE=/app/docker-compose.yml
      - CONFIG_DIR=/app/config
      - DATABASE_PATH=/app/data/settings.db
      - TRAEFIK_DYNAMIC_CONFIG=/etc/traefik/dynamic_config.yml
      - TRAEFIK_ACCESS_LOG=/var/log/traefik/access.log
      - BACKUP_DIR=/app/backups
      - INCLUDE_CROWDSEC=true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./config:/app/config
      - ./docker-compose.yml:/app/docker-compose.yml
      - ./backups:/app/backups
      - ./logs/app:/app/logs
      - ./data:/app/data
      - ./logs/traefik:/var/log/traefik:ro
    networks:
      - crowdsec-network
    depends_on:
      - crowdsec
      - traefik
  # traefik, pangolin, gerbil, crowdsec services...
networks:
  crowdsec-network:
    driver: bridge

Independentstandalone

Full guide →

CrowdSec + manager only. Pre-built image. No Traefik, no Pangolin. Bring your own reverse proxy.

services:
  crowdsec-manager:
    image: hhftechnology/crowdsec-manager:independent
    container_name: crowdsec-manager
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - ENVIRONMENT=production
      - 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
    environment:
      - COLLECTIONS=crowdsecurity/linux
    volumes:
      - crowdsec-db:/var/lib/crowdsec/data/
      - crowdsec-config:/etc/crowdsec/
    networks:
      - crowdsec-network

networks:
  crowdsec-network:
    driver: bridge

volumes:
  crowdsec-db:
  crowdsec-config: