Get Muzikk

Download

Muzikk ships as a single Docker image built from the repository. One compose file, three volumes, and a Jellyfin API key.

Coming soon

The repository is not public yet

Muzikk is still being finished off. The source code and the build instructions will be published on GitHub, and this page will link straight to it — nothing else about the installation will change.

GitHub — coming soon Read the documentation
Current version · 0.1.0 Self-hosted, no telemetry, no account outside your own Jellyfin.

Download

Quick start

Once the repository is available, this is the whole installation.

Create the shared network

Muzikk reaches Jellyfin, slskd, Prowlarr and qBittorrent by container name, so they all need to sit on one external network.

bash
docker network create mediastack

Clone and configure

Set PUID and PGID to the owner of your music library, then give the host paths for the library and the downloads.

bash
git clone <repository> muzikk
cd muzikk
cp .env.example .env
$EDITOR .env

Build and start

The image carries the API, the interface and the worker. Nothing else has to be provisioned.

bash
docker compose up -d --build

Finish in the browser

Open http://your-host:8383, give the setup wizard your Jellyfin URL and API key, pick the music libraries, then sign in with a Jellyfin administrator account.

Requirements

What you need around it

Jellyfin is required. Beyond that, one download provider is enough to get going.

Jellyfin

Accounts, permissions, the music library and the rescan. Required.

jellyfin.org

MusicBrainz

The catalogue. A self-hosted instance with Solr is recommended; the public server can stand in.

musicbrainz.org

slskd

Soulseek downloading. One of the two provider families.

github.com

Prowlarr + qBittorrent

Torrent search and downloading. The other provider family.

prowlarr.com

While you wait

The documentation is already complete: requirements, volumes and paths, every service section, the naming template, how a candidate is scored, and the mistakes that actually happen.