How to Set Up Lidarr with Docker Compose (Step-by-Step Video)

Lidarr logo with the words install with Docker Compose, for your music library

For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer

Updated 16 November 2026 Tested with: Lidarr 3.1.6

Lidarr does for music what Radarr does for films. You add the artists you like, and it finds their albums, sends them to your download client, then names and files everything neatly so Plex or Jellyfin show proper artists, albums and track lists. When an artist releases something new, Lidarr grabs it on its own.

This guide sets up Lidarr with Docker Compose in seven short steps. It takes about 20 minutes.

Already got Radarr or Sonarr? Lidarr will feel familiar: same layout, same settings, same Prowlarr connection. The two things that catch people out are both music-only: the metadata profile (which kinds of release it lists) and the download category. The demo below shows both.
On this page (13 sections)

Watch: install Lidarr with Docker Compose

The video has subtitles at the bottom and no sound. It was recorded on a clean test install. The test artist is Kevin MacLeod, a composer who shares his music under a Creative Commons licence; artist photos were turned off for the recording.

See which albums Lidarr will grab

Change the metadata profile, Monitor option and quality profile to see which releases Lidarr lists and goes looking for, then press Search. Tick Rename Tracks to see the difference it makes. Under the demo is the generator you’ll use in Step 1.


Open the generator full screen

What you need to set up Lidarr with Docker Compose

Step 1: Make your compose file

In the generator, choose On its own (recommended), pick your download client, and use the same data folder as your download client and Plex. Then:

mkdir -p ~/lidarr && cd ~/lidarr

Save compose.yaml and .env there, and run the commands from the Commands tab. Lidarr opens at http://YOUR-SERVER-IP:8686.

Step 2: Set your login

The first time you open Lidarr, it asks you to turn on a login. Set Authentication Method to Forms (Login Page), pick a Username and Password, and click Save.

Lidarr Authentication Required window with Forms login, username and password highlighted
The login window you see on first start.

Step 3: Add your music folder

  1. Go to Settings → Media Management and click the big + under Root Folders.
  2. Name: Music. Path: /data/media/music.
  3. Quality Profile: Standard (MP3 and AAC, small files) or Lossless (FLAC, about four times bigger). Leave the rest and click Save.
Lidarr Add Root Folder with path /data/media/music and Standard quality profile highlighted
Settings → Media Management → Add Root Folder.

On the same page, tick Rename Tracks and click Save Changes. It’s off by default, so files would keep whatever names the uploader gave them.

Lidarr Track Naming with Rename Tracks ticked and the standard track format
Rename Tracks on. The default format is a good one.

Step 4: Connect your download client

Go to Settings → Download Clients → + and pick yours. Enter your server’s IP, the port and the login, then set the Category:

  • qBittorrent: change lidarr to music, so downloads land in /data/torrents/music.
  • SABnzbd: change music to audio. SABnzbd’s built-in music category is called audio, and with music the test fails with “Category does not exist”. I tested both.
  • NZBGet: leave it as Music. It already matches.

Click Test (a green tick means it worked), then Save.

Lidarr qBittorrent download client with host, port, username, password and category music highlighted
qBittorrent, with the category changed to music. Use your own server IP.

Step 5: Connect Prowlarr

  1. In Lidarr, go to Settings → General and copy the API Key.
  2. In Prowlarr, go to Settings → Apps → + and pick Lidarr.
  3. Prowlarr Server: http://YOUR-SERVER-IP:9696. Lidarr Server: http://YOUR-SERVER-IP:8686. Paste the API Key.
  4. Click Test, then Save. Prowlarr copies your music indexers into Lidarr within a minute.
Prowlarr Add Application Lidarr with Prowlarr Server, Lidarr Server and API Key highlighted
Prowlarr → Settings → Apps → Lidarr.

Step 6: Add your first artist

  1. Go to Library → Add New and type an artist’s name.
  2. Click the right result. Check the description: lots of artists share a name.
  3. Monitor: All Albums grabs the whole discography. For a big artist, start with Latest Album.
  4. Quality Profile: check it. On a fresh install this window starts on Any, not the profile you gave your folder.
  5. Tick Start search for missing albums and click Add.
Lidarr Add New Artist window with Monitor All Albums, Quality Profile Standard and Start search for missing albums highlighted
Adding an artist. The artist photo is hidden here.

The artist page then lists their albums and how many you have. 🎉

Lidarr artist page showing the music folder, Standard profile, Monitored and 0 of 76 albums
The artist page: albums found, none downloaded yet.
Where are the EPs and singles? The default Standard metadata profile only lists official studio albums. To get EPs, singles or live albums too, go to Settings → Profiles → Metadata Profiles, add a profile with those types ticked, then pick it when you add an artist (or click Edit on an artist you’ve already added).

Step 7: Add the music to Plex or Jellyfin

Add a Music library pointing at /data/media/music: in Plex, choose the Music library type; in Jellyfin, the Music content type. Because Lidarr names the folders and files properly, both match artists and albums correctly.

If something’s wrong

  • “Category does not exist” with SABnzbd. Use audio, not music (Step 4).
  • Albums download but never import. Lidarr and your download client must share the same data folder, so both see /data/torrents or /data/usenet.
  • Lidarr finds nothing. Check Prowlarr has an indexer with music, and that it synced (Lidarr → Settings → Indexers). Old or obscure albums may simply not be available.
  • Too many albums being grabbed. Click Artist Monitoring on the artist page and choose Latest Album or Future Albums.
  • The wrong artist was added. Delete it (don’t tick “delete files” if you have some) and add the right one. Check the description under the name in the search results.
  • Files have messy names. Tick Rename Tracks (Step 3), then use Preview Rename on each artist page to tidy what’s already there.

Updating Lidarr

cd ~/lidarr
docker compose pull && docker compose up -d

Frequently asked questions

What does Lidarr do?

Lidarr does for music what Radarr does for films. Add the artists you like and it finds their albums, sends them to your download client, then names and files everything so Plex or Jellyfin show proper artists, albums and track lists.

Why does SABnzbd say "Category does not exist" for Lidarr?

SABnzbd's music category is called audio, not music. Use audio in Lidarr's download client settings.

How do I stop Lidarr grabbing an artist's whole back catalogue?

Click Artist Monitoring on the artist page and choose Latest Album or Future Albums.

Why do albums download but never import?

Lidarr and your download client must share the same data folder, so both see /data/torrents or /data/usenet.

Thank you

Lidarr is free and open source, made by the Lidarr team, with music data from MusicBrainz. Thanks also to LinuxServer.io for the image.

Related guides: Media Server Stack · Radarr · Sonarr · Prowlarr · Plex

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply