docker-compose/stirling-pdf/docker-compose.yml

# Stirling PDF Service Configuration
services:
  stirling-pdf:
    # Basic container configuration
    container_name: stirling-pdf
    image: ghcr.io/stirling-tools/stirling-pdf:1.0.2-fat  # Full-featured image
    restart: unless-stopped  # Auto-recover from crashes
    
    # Application settings
    environment:
      - DISABLE_ADDITIONAL_FEATURES=${DISABLE_ADDITIONAL_FEATURES}  # Toggle extra features
      - DOCKER_ENABLE_SECURITY=${DOCKER_ENABLE_SECURITY}  # Enable security restrictions
      - SECURITY_ENABLELOGIN=${SECURITY_ENABLELOGIN}  # Require authentication
      - LANGS=${LANGS}  # Supported languages for OCR
      - SHOW_SURVEY=false  # Disable user surveys
      - DISABLE_PIXEL=true  # Disable pixel tracking
    
    # Persistent storage configuration
    volumes:
      - ${APPDATA_DATA}/stirling-pdf/training_data:/usr/share/tessdata  # OCR training data
      - ${APPDATA_DATA}/stirling-pdf/config:/configs  # Configuration files
      - ${APPDATA_DATA}/stirling-pdf/custom_files:/customFiles/  # User uploads
      - ${APPDATA_DATA}/stirling-pdf/logs:/logs/  # Application logs
      - ${APPDATA_DATA}/stirling-pdf/pipeline:/pipeline/  # Processing pipelines
    
    # Network configuration
    ports:
      - ${PORT}:8080  # Web interface port
    networks:
      - frontend  # Connects to frontend network

# External network definition
networks:
  frontend:
    external: true  # Uses existing Docker network