Skip to content

Getting Started

MusicSeerr is a music discovery and management tool that connects your media stack — Lidarr, Jellyfin, ListenBrainz, MusicBrainz, and more — into a single, unified experience.

Prerequisites

  • Docker and Docker Compose installed on your system
  • A running Lidarr instance with an API key
  • (Optional) Jellyfin, ListenBrainz, or Last.fm accounts for enhanced features

Quick Install

Create a docker-compose.yml file:

services:
  musicseerr:
    image: ghcr.io/habirabbu/musicseerr:latest
    container_name: musicseerr
    ports:
      - "5877:5877"
    volumes:
      - ./config:/config
      - /path/to/music:/music:ro
    environment:
      - PUID=1000
      - PGID=1000
    restart: unless-stopped

Then start the container:

docker compose up -d

MusicSeerr will be available at http://localhost:5877.

First-Time Setup

  1. Connect Lidarr — Enter your Lidarr URL and API key in Settings → Connections. This is the only required integration.
  2. Sync your library — MusicSeerr will automatically import your Lidarr library on first connection.
  3. Add optional services — Connect Jellyfin, ListenBrainz, or YouTube for additional features like playback, listening stats, and music discovery.

Updating

To update to the latest version:

docker compose pull
docker compose up -d

Next Steps