2. Quick Start

This guide gets Explo running with Docker and the web UI in a few minutes.

Prerequisites

Before starting, make sure you have:

• A self-hosted music system:

  • Emby
  • Jellyfin
  • Plex
  • Any Subsonic-compatible server (Navidrome, Airsonic, etc.)

• ListenBrainz scrobbling configured

Setup (Docker)

Create a folder with all the needed subfolders for Explo:

mkdir -p explo/config
cd explo

create the docker compose file

nano docker-compose.yaml

Paste the following configuration into docker-compose.yaml:

services:
  explo:
    image: ghcr.io/lumepart/explo:latest
    restart: unless-stopped
    container_name: explo
    ports:
      - "7288:7288"
    volumes:
      - ./explo/.env:/opt/explo/.env
      - ./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
    environment:
      - TZ=UTC # Change this to the timezone set in ListenBrainz (default is UTC)
      - WEB_UI=true
      # Web UI credentials (required for login)
      - UI_USERNAME=testuser
      - UI_PASSWORD=testpassword

Start Explo

Run:

docker compose up -d

---

Access the Web UI

Open:

http://YOUR_SERVER_IP:7288

Log in using the credentials defined in docker-compose.yaml.

---

Initial Configuration

After logging in, follow the setup wizard to configure:

• Discovery
• Music system
• Downloaders

For all available configuration options, see:

Configuration Parameters

Setup (binary)

Explo can be run as a simple binary without a need for an UI, steps for installing the binary are described here