CrowdSec Manager

A web-based management interface for CrowdSec — decisions, alerts, allowlists, scenarios, hub, logs, backups, and Traefik integration.

Mobile App

Coming Soon

For Pangolin Users

For Multi Proxy(independent)

Mobile Screenshots

Connection Setup	Dashboard Overview	Security IP Check
Security Alerts List	Security Metrics	Logs Viewer
Management Home	Allowlists Management	Hub Management
Scenarios Management	Container Controls	Terminal Shell

Native iOS and Android app. Supports Pangolin (token-based remote access) and Basis (direct URL) connection modes.

Release

• Version: 2.3.4
• Pangolin image: hhftechnology/crowdsec-manager:latest — full stack with Traefik, Pangolin, Gerbil
• Independent image: hhftechnology/crowdsec-manager:independent — CrowdSec only, no Traefik
• Image size (linux/amd64): 44MB

Quick Start

Pangolin (full stack)

  # Your CrowdSec Manager
  crowdsec-manager:
    image: hhftechnology/crowdsec-manager:latest
    container_name: crowdsec-manager
    restart: unless-stopped
    environment:
      - PORT=8080
      - ENVIRONMENT=production
      - TRAEFIK_DYNAMIC_CONFIG=/etc/traefik/dynamic_config.yml
      - TRAEFIK_CONTAINER_NAME=traefik
      - TRAEFIK_STATIC_CONFIG=/etc/traefik/traefik_config.yml
      - CROWDSEC_METRICS_URL=http://crowdsec:6060/metrics
      - ALERT_LIST_LIMIT=5000
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /root/config:/app/config # pangolin config folder
      - /root/docker-compose.yml:/app/docker-compose.yml # pangolin compose yml
      - ./crowdsec-manager/backups:/app/backups
      - ./crowdsec-manager/data:/app/data
    depends_on:
      crowdsec:
        condition: service_healthy
docker compose up -d

Independent (CrowdSec only)

mkdir -p ./config/crowdsec ./logs/app ./data

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:
      - ./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/stack

Screenshots

Documentation

Full installation guide, configuration reference, mobile app setup, and API docs: crowdsec-manager.hhf.technology

License

MIT — see LICENSE.

Support

• GitHub Issues
• Discord