docker-compose.yaml

services:
  explo:
    image: ghcr.io/lumepart/explo:latest
    restart: unless-stopped
    container_name: explo
    ports:
      - "7288:7288"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - /path/to/.env:/opt/explo/.env
      - /path/to/explo/config:/opt/explo/config # required — stores playlist cache and cover art
      - /path/to/musiclibrary/explo:/data/ # has to be in the same path you have your music system pointed to (it's recommended to put explo under a subfolder)
      # - /path/to/slskd/downloads:/slskd/ # if using slskd and MIGRATE_DOWNLOADS is set to true in .env
      # - $PLAYLIST_DIR:$PLAYLIST_DIR # for MPD. Both paths should be as defined in .env (e.g /my/playlists/:/my/playlists/)
      
      # - /path/to/cookies.txt:/opt/explo/cookies.txt # Path to optional cookies file (for yt-dlp)
    environment:
      - TZ=UTC # Change this to the timezone set in ListenBrainz (default is UTC)

      # [Legacy] Schedules are managed through the web UI.
      # These can still be set here for backwards compatibility — they will take precedence over the UI.
      #- WEEKLY_EXPLORATION_SCHEDULE=15 00 * * 2
      #- WEEKLY_EXPLORATION_FLAGS=
      #- WEEKLY_JAMS_SCHEDULE=30 00 * * 1
      #- WEEKLY_JAMS_FLAGS=--playlist=weekly-jams --download-mode=skip
      #- DAILY_JAMS_SCHEDULE=15 01 * * *
      #- DAILY_JAMS_FLAGS=--playlist=daily-jams --download-mode=skip

      # Uncomment for testing (runs explo right after launcing the container)
      #- EXECUTE_ON_START=false # Whether to run explo when starting the container (useful for testing)
      #- START_FLAGS=--persist=false # if needed, set startup flags for testing