docker-compose.example.yml

services:
  musicseerr:
    image: ghcr.io/habirabbu/musicseerr:latest
    container_name: musicseerr
    environment:
      - PUID=1000            # User ID — run `id` on your host to find yours
      - PGID=1000            # Group ID — run `id` on your host to find yours
      #                        Unraid: use 99/100 (nobody:users) unless you changed Unraid's defaults.
      #                        If using Docker --user, PUID/PGID are ignored (user mapping is external).
      - PORT=8688            # Internal port (must match the right side of "ports" below)
      - TZ=Etc/UTC           # Timezone — e.g. America/New_York, Europe/London
    ports:
      - "8688:8688"         # <host-port>:<container-port> — change the left side to remap
    volumes:
      - ./config:/app/config  # Persistent app configuration
      - ./cache:/app/cache    # Cover art & metadata cache
      # Optional: mount your music library for local file playback
      # The left side is the host path to your music (same as Lidarr's root folder).
      # The right side (/music) must match the "Music Directory Path" in Settings > Local Files.
      # - /path/to/music:/music:ro
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8688/health"]
      interval: 30s
      timeout: 10s
      start_period: 15s
      retries: 3