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
      - SYSTEM_ENABLEANALYTICS=false  # Disable analytics
    
    # 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

    # Health check configuration
    healthcheck:
      test: [ "CMD-SHELL", "curl -f http://localhost:8080/api/v1/info/status | grep -q 'UP'" ]
      interval: 5s
      timeout: 10s
      retries: 5
      start_period: 40s