n8n Docker Compose Examples — Copy One or Generate Yours

# n8n 2.x · SINGLE mode · sized for 300 runs/day (peak ≈10 concurrent)
# Generated by the n8n Server Sizing Calculator · topology follows n8n-io/n8n-hosting
name: n8n
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:stable
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"   # proxy handles the public side
    env_file: .env
    volumes:
      - n8n_data:/home/node/.n8n
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer
    depends_on:
      postgres:
        condition: service_healthy
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_DB=n8n
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=change-me
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n"]
      interval: 10s
      retries: 5
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer
  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }

volumes:
  n8n_data:
  pg_data:
  caddy_data:
  caddy_config:
# Production hardening: move task runners to a sidecar (external mode) —
#   n8n docs → Hosting → Configuration → Task runners (image: n8nio/runners:stable)

# n8n 2.x · QUEUE mode · main + 2 workers + Redis + Postgres
# Generated by the n8n Server Sizing Calculator · topology follows n8n-io/n8n-hosting
name: n8n
services:
  n8n-main:
    image: docker.n8n.io/n8nio/n8n:stable
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"   # proxy handles the public side
    env_file: .env
    volumes:
      - n8n_data:/home/node/.n8n
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started

  n8n-worker:
    image: docker.n8n.io/n8nio/n8n:stable
    restart: unless-stopped
    command: worker --concurrency=10
    env_file: .env
    deploy:
      replicas: 2
    volumes:
      - n8n_data:/home/node/.n8n
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer
    depends_on:
      - n8n-main

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: redis-server --maxmemory 128mb --maxmemory-policy noeviction
    volumes:
      - redis_data:/data
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_DB=n8n
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=change-me
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n"]
      interval: 10s
      retries: 5
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }   # unrotated logs are the classic disk-killer

  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }

volumes:
  n8n_data:
  redis_data:
  pg_data:
  caddy_data:
  caddy_config:
# Notes:
# · every service shares one .env → same N8N_ENCRYPTION_KEY (mandatory in queue mode)
# · binary data in 2.x queue mode lives in Postgres (filesystem unsupported; S3 = Enterprise license)
# · scale workers: docker compose up -d --scale n8n-worker=3

# ── n8n 2.x · generated by n8n Server Sizing Calculator ──
# Sized for: 300 runs/day · peak concurrency ≈10 · SINGLE mode

# ── network ──
N8N_HOST=n8n.example.com
WEBHOOK_URL=https://n8n.example.com/
N8N_PROTOCOL=https
N8N_PROXY_HOPS=1   # trust one reverse proxy in front (X-Forwarded-For)
GENERIC_TIMEZONE=UTC
N8N_ENCRYPTION_KEY=change-me-openssl-rand-hex-24

# ── execution history (drives DB size — 4,200 runs ≈ 1 GB) ──
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=336
EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000
# High volume? Stop storing successful runs:
# EXECUTIONS_DATA_SAVE_ON_SUCCESS=none

# ── memory ──
# Heap: Node's default old-space can lag your RAM — pin it to ~60% of the box
NODE_OPTIONS=--max-old-space-size=4915
# 2.x: task runners are always on (N8N_RUNNERS_ENABLED is deprecated — don't set it).
# For production, run runners as a sidecar (external mode) — see docs: hosting/configuration/task-runners
N8N_RUNNERS_MAX_OLD_SPACE_SIZE=1229

# ── database ──
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=change-me
DB_POSTGRESDB_POOL_SIZE=12   # default is only 2

# ── single-mode guard against RAM storms ──
N8N_CONCURRENCY_PRODUCTION_LIMIT=10