Installation

This is the canonical setup for CrowdSec Manager 1.0.0.

Prerequisites

Docker running on the host.
Docker Compose v2.
External Docker network pangolin.

1. Prepare host paths

mkdir -p ./backups
mkdir -p ./data

2. Create or update docker-compose.yml

Use this minimum compose file:

services:
  crowdsec-manager:
    image: hhftechnology/crowdsec-manager:1.1.0
    container_name: crowdsec-manager
    restart: unless-stopped
    expose:
      - "8080"
    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
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /root/config:/app/config
      - /root/docker-compose.yml:/app/docker-compose.yml
      - ./backups:/app/backups
      - ./data:/app/data
    networks:
      - pangolin

networks:
  pangolin:
    external: true

3. Ensure `pangolin` network exists

docker network create pangolin

If the network already exists, Docker will return an error and you can ignore it.

4. Start CrowdSec Manager

docker compose up -d

5. Verify

curl http://localhost:8080/health

If the endpoint returns healthy status, open the UI on http://localhost:8080 or behind your existing reverse proxy route.

Installation

Installation

Prerequisites

1. Prepare host paths

2. Create or update docker-compose.yml

3. Ensure pangolin network exists

4. Start CrowdSec Manager

5. Verify

On this page

3. Ensure `pangolin` network exists