CrowdSec-Manager Docs
Configuration

Volumes & Persistence

Required and optional volume mappings for each deployment variant

Volumes & Persistence

Pangolin variant

Host pathContainer pathPurpose
/var/run/docker.sock/var/run/docker.sockDocker API access for service management
./config/app/configCrowdSec config directory
./docker-compose.yml/app/docker-compose.ymlCompose file used for stack operations
./backups/app/backupsBackup artifacts
./logs/app/app/logsApplication logs
./data/app/dataSQLite databases (settings + history)
./logs/traefik/var/log/traefik (read-only)Traefik logs for in-app analysis
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

Independent variant

Host pathContainer pathPurpose
/var/run/docker.sock/var/run/docker.sockDocker API access
./config/app/configCrowdSec config directory
./logs/app/app/logsApplication logs
./data/app/dataSQLite databases (settings + history)
volumes:
  - /var/run/docker.sock:/var/run/docker.sock
  - ./config:/app/config
  - ./logs/app:/app/logs
  - ./data:/app/data

No backup volume and no Traefik log volume are needed for the Independent variant.

Prepare host directories

mkdir -p ./config ./data ./logs/app
# Pangolin only:
mkdir -p ./backups ./logs/traefik

Notes

  • All paths in environment variables refer to in-container paths. Use volume mappings to connect them to your host.
  • The docker.sock mount is required for all container management features. Ensure the host socket exists at /var/run/docker.sock.

On this page