# MinIO Object Storage Service Configuration
services:
  # MinIO Server Service
  minio:
    # Basic container configuration
    container_name: minio
    image: docker.io/minio/minio:RELEASE.2025-06-13T11-33-47Z  # Official MinIO image
    restart: unless-stopped  # Auto-restart on failure
    
    # Runtime command and user permissions
    command: server /data  # Start in server mode
    user: ${PUID}:${PGID}  # Run as specified user/group
    
    # Environment variables for authentication and configuration
    environment:
      - MINIO_ROOT_USER=${MINIO_ROOT_USER}  # Admin username
      - MINIO_ROOT_PASSWORD=${MINIO_ROOT_PASSWORD}  # Admin password
      - MINIO_SERVER_URL=${MINIO_SERVER_URL}  # Public server endpoint URL
      - MINIO_BROWSER_REDIRECT_URL=${MINIO_BROWSER_REDIRECT_URL}  # Web console redirect URL
    
    # Persistent data storage
    volumes:
      - ${APPDATA_PATH}/minio/data:/data  # Maps host directory to container
    
    # Network ports
    ports:
      - ${API_PORT}:9000  # MinIO API port

    # Health check configuration
    healthcheck:
      test: ["CMD", "mc", "ready", "local"]
      interval: 5s
      timeout: 5s
      retries: 5

  # MinIO Console Service (separate from main server)
  minio-console:
    # Basic container configuration
    container_name: minio-console
    image: ghcr.io/georgmangold/console:v1.8.1  # Community console UI
    restart: unless-stopped  # Auto-restart on failure
    
    # Service dependencies
    depends_on:
      minio:
        condition: service_healthy
    
    # Environment configuration
    environment:
      - CONSOLE_MINIO_SERVER=http://minio:9000  # Points to MinIO server
    
    # Network ports
    ports:
      - ${CONSOLE_PORT}:9090  # Web console access port