docker-compose.v2.dev.yml

services:
  mysql:
    image: mariadb:latest
    container_name: featherpanel_mysql
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD:-featherpanel_root}
      MARIADB_DATABASE: ${MARIADB_DATABASE:-featherpanel}
      MARIADB_USER: ${MARIADB_USER:-featherpanel}
      MARIADB_PASSWORD: ${MARIADB_PASSWORD:-featherpanel_password}
      MARIADB_AUTO_UPGRADE: "1"
    volumes:
      - mariadb_data:/var/lib/mysql
      - ./mysql/init:/docker-entrypoint-initdb.d
    networks:
      - featherpanel_network
    healthcheck:
      test:
        [
          "CMD",
          "mariadb-admin",
          "ping",
          "-h",
          "localhost",
          "-u",
          "root",
          "-pfeatherpanel_root",
        ]
      timeout: 20s
      retries: 10

  redis:
    image: redis:latest
    container_name: featherpanel_redis
    restart: unless-stopped
    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD:-featherpanel_redis}
    volumes:
      - redis_data:/data
    networks:
      - featherpanel_network
    depends_on:
      mysql:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      timeout: 20s
      retries: 10

  backend:
    image: ghcr.io/mythicalltd/featherpanel-backend:dev
    container_name: featherpanel_backend
    restart: unless-stopped
    environment:
      - DATABASE_HOST=mysql
      - DATABASE_PORT=3306
      - DATABASE_DATABASE=${MARIADB_DATABASE:-featherpanel}
      - DATABASE_USER=${MARIADB_USER:-featherpanel}
      - DATABASE_PASSWORD=${MARIADB_PASSWORD:-featherpanel_password}
      - DATABASE_ENCRYPTION=xchacha20
      - REDIS_HOST=redis
      - REDIS_PASSWORD=${REDIS_PASSWORD:-featherpanel_redis}
      - TRUST_PROXY_HEADERS=true
      - PANEL_DOCKER_DEPLOYMENT=true
      # FrankenPHP worker mode for /api/* (default); set to false for classic mode
      - FRANKENPHP_WORKER=${FRANKENPHP_WORKER:-true}
      - FEATHERPANEL_VERSION_CHANNEL=development
      - DOCKER_UPDATER_URL=http://host.docker.internal:9418/update
      - DOCKER_UPDATER_TOKEN=${DOCKER_UPDATER_TOKEN:-}
    extra_hosts:
      - "host.docker.internal:host-gateway"
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
    healthcheck:
      # HTTP check through FrankenPHP + database; /api/system/settings is the
      # fallback for images built before /api/system/health existed.
      test:
        [
          "CMD-SHELL",
          "curl -fsS -o /dev/null http://127.0.0.1/api/system/health || curl -fsS -o /dev/null http://127.0.0.1/api/system/settings",
        ]
      interval: 30s
      timeout: 10s
      retries: 10
      start_period: 180s
    volumes:
      - featherpanel_attachments:/var/www/html/public/attachments
      - featherpanel_config:/var/www/html/storage/config
      - featherpanel_snapshots:/var/www/html/storage/backups
      - featherpanel_logs:/var/www/html/storage/logs
      - featherpanel_translations:/var/www/html/public/translations
      - featherpanel_addons:/var/www/html/storage/addons
      - featherpanel_data:/var/www/html/storage/data
      - featherpanel_pma:/var/www/html/public/pma
      - featherpanel_webmail:/var/www/html/public/webmail
    networks:
      - featherpanel_network

  frontendv2:
    image: ghcr.io/mythicalltd/featherpanel-frontendv2:dev
    container_name: featherpanel_frontendv2
    restart: unless-stopped
    environment:
      - INTERNAL_API_URL=http://backend:80
    volumes: []
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
      backend:
        condition: service_healthy
    healthcheck:
      test:
        [
          "CMD",
          "wget",
          "--quiet",
          "--tries=1",
          "--spider",
          "http://localhost:80",
        ]
      timeout: 20s
      retries: 10
    ports:
      - "${FEATHERPANEL_PANEL_PORT:-4831}:80"
    networks:
      - featherpanel_network

  mcp:
    image: ghcr.io/mythicalltd/featherpanel-mcp:dev
    container_name: featherpanel_mcp
    restart: unless-stopped
    environment:
      - FEATHERPANEL_URL=http://backend:80
      - MCP_HOST=0.0.0.0
      - MCP_PORT=3001
      - MCP_OAUTH_STORE_PATH=/data/oauth-store.json
      - MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL=true
    volumes:
      - mcp_oauth_data:/data
    depends_on:
      backend:
        condition: service_healthy
    healthcheck:
      test:
        [
          "CMD",
          "node",
          "-e",
          "fetch('http://127.0.0.1:3001/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))",
        ]
      timeout: 10s
      retries: 5
      start_period: 10s
    networks:
      - featherpanel_network

  async-runner:
    image: ghcr.io/mythicalltd/featherpanel-async-runner:dev
    container_name: featherpanel_async_runner
    restart: unless-stopped
    sysctls:
      - net.ipv6.conf.all.disable_ipv6=1
      - net.ipv6.conf.default.disable_ipv6=1
      - net.ipv6.conf.lo.disable_ipv6=1
    environment:
      - RUST_LOG=info
      - LOG_DIR=/var/www/html/storage/logs
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=${MARIADB_DATABASE:-featherpanel}
      - DB_USER=${MARIADB_USER:-featherpanel}
      - DB_PASS=${MARIADB_PASSWORD:-featherpanel_password}
      - REDIS_URL=redis://:${REDIS_PASSWORD:-featherpanel_redis}@redis:6379
    volumes:
      - featherpanel_config:/app/config:ro
      - featherpanel_logs:/var/www/html/storage/logs
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
      frontendv2:
        condition: service_healthy
      backend:
        condition: service_healthy
    networks:
      - featherpanel_network

volumes:
  mariadb_data:
    driver: local
  redis_data:
    driver: local
  featherpanel_attachments:
    driver: local
  featherpanel_config:
    driver: local
  featherpanel_snapshots:
    driver: local
  featherpanel_logs:
    driver: local
  featherpanel_translations:
    driver: local
  featherpanel_addons:
    driver: local
  featherpanel_data:
    driver: local
  featherpanel_pma:
    driver: local
  featherpanel_webmail:
    driver: local
  mcp_oauth_data:
    driver: local

networks:
  featherpanel_network:
    driver: bridge