docker-compose.yml

# ══════════════════════════════════════════════════════════════
# MapArr v1.5.0 — Docker Compose
#
# Quick start:
#   1. Set STACKS_PATH below to your Docker stacks directory
#   2. docker compose up -d
#   3. Open http://localhost:9494
#
# PUID/PGID: Set these to match your host user (run `id` to check).
# This ensures MapArr can read your compose files and write fixes.
# ══════════════════════════════════════════════════════════════

services:
  maparr:
    image: ghcr.io/coaxk/maparr:latest
    container_name: maparr
    restart: unless-stopped

    ports:
      - "${MAPARR_PORT:-9494}:${MAPARR_PORT:-9494}"

    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - MAPARR_PORT=${MAPARR_PORT:-9494}
      - LOG_LEVEL=${LOG_LEVEL:-info}
      # Uncomment for socket proxy instead of socket mount:
      # - DOCKER_HOST=tcp://socket-proxy:2375

    volumes:
      # REQUIRED: Your Docker stacks directory (where your compose files live)
      - ${STACKS_PATH:-/opt/docker}:/stacks:ro
      # OPTIONAL: Docker socket for full compose resolution
      # Remove this line if using a socket proxy (set DOCKER_HOST above instead)
      - /var/run/docker.sock:/var/run/docker.sock:ro
      # OPTIONAL: Custom image overrides (see QUICK_START.md)
      # - ./custom-images.json:/data/custom-images.json:ro

    # For Apply Fix (writing corrected compose files), change :ro to :rw above
    # or remove the :ro flag entirely.

    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:${MAPARR_PORT:-9494}/api/health"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"