sublogue/docker-compose.yml

version: "3.9"

# Sublogue main app stack
services:
  sublogue:
    # Build the private image from this repository root
    build:
      context: .
    image: sublogue:local
    # Explicit container name for easy discovery
    container_name: sublogue
    # Always restart unless manually stopped
    restart: unless-stopped

    # Environment variables for permissions + timezone (Linux servers)
    environment:
      - TZ=Etc/UTC           # Set timezone
      - PUID=1000            # Set user ID for file permissions
      - PGID=1000            # Set group ID for file permissions

    # Persist data/configuration
    volumes:
      - ./data:/config       # App configuration and database
      - ./media:/media       # Media library mount (read/write)

    # Expose the web UI + API
    ports:
      - "5000:5000"          # Web UI + API (Flask)

    # Healthcheck for uptime monitoring
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://localhost:5000/api/health || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 15s

    # Use the shared network if it exists
    networks:
      - npm_network

# Dedicated network (uses existing npm_network if present)
networks:
  npm_network:
    external: true