Skip to content

Getting Started

MusicSeerr is a music discovery and management tool that ties together your media stack. It connects Lidarr, Jellyfin, Navidrome, ListenBrainz, Last.fm, and MusicBrainz into a single interface for browsing, requesting, playing, and discovering music.

Prerequisites

  • Docker and Docker Compose installed on your system
  • A running Lidarr instance with an API key
  • (Optional) A Jellyfin or Navidrome server for streaming playback
  • (Optional) ListenBrainz and/or Last.fm accounts for recommendations and scrobbling

Quick Install

Create a docker-compose.yml file:

services:
  musicseerr:
    image: ghcr.io/habirabbu/musicseerr:latest
    container_name: musicseerr
    environment:
      - PUID=1000
      - PGID=1000
      - PORT=8688
      - TZ=Etc/UTC
    ports:
      - "8688:8688"
    volumes:
      - ./config:/app/config
      - ./cache:/app/cache
      - /path/to/music:/music:ro
    restart: unless-stopped

Then start the container:

docker compose up -d

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

The /music volume mount is optional. It enables the local file browser and playback for music you already have on disk. If you only plan to stream through Jellyfin or Navidrome, you can leave it out.

First-Time Setup

  1. Connect Lidarr - Go to Settings and enter your Lidarr URL and API key. This is the only required integration. MusicSeerr will sync your library automatically on first connection.
  2. Set up playback - Connect Jellyfin, Navidrome, or both for streaming. You can also mount your music directory for local file playback, or enable YouTube for tracks that aren’t in your library yet.
  3. Enable scrobbling - Link your Last.fm account (via OAuth) and/or your ListenBrainz account to scrobble as you listen. Both can run at the same time.
  4. Explore discovery - Once ListenBrainz or Last.fm is connected, the Discover page and Home page will populate with personalised recommendations, trending artists, and more.

Updating

To update to the latest version:

docker compose pull
docker compose up -d

Your configuration and cache are stored in the mounted volumes, so updates won’t lose any data.

Next Steps