selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Lidarr logo

Self-host Lidarr

v3.1.6.5079

Usenet and BitTorrent music collection automation

ReleaseOpen SourceGPL-3.0
yay -S lidarr-bin
Updated2 weeks ago
LanguageC#
Setup difficultyModerate
Stars
5 826
Ports
8686 (Lidarr's web server / UI), 6868 (HTTPS UI port, used only when Enable SSL is on)
Artist detail page with the artist's album listQuality profile editor with customisable thresholdsNotification settings screenLibrary shown as a poster gridLibrary shown as a table viewLibrary overview pageIn-app update history viewCalendar of upcoming album releasesManual search results for a release

What is Lidarr?

Lidarr alternatives

Should you self-host Lidarr?

Lidarr scores 72/100 on selfhost.directory (how scoring works) and ranks #6 of 141 in Media Management. It has 5 826 GitHub stars, +94 in the last 30 days.

It shipped 15 stable releases in the past year. The latest, v3.2.1.5196, came out on 8 November 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. It is GPL-3.0-licensed and written mostly in C#.

Its closest alternative on selfhost.directory is Sonarr (80/100, 17 711 stars). It scores higher overall, so compare the two before you pick. See Lidarr vs Sonarr side by side.

Features

  • Audio metadata tagging
  • Automatic failed download handling
  • Automatic quality upgrade
  • Calendar View
  • Custom Formats
  • Custom Scripts
  • Custom track renaming
  • Existing library import
  • Import lists
  • Manual Search
  • Plugin SupportRequires the develop or nightly branch.
  • REST API
  • RSS Feed Monitoring
  • Special and multi-album release support

Lidarr README

Lidarr

Build Status Translation status Docker Pulls Github Downloads Backers on Open Collective Sponsors on Open Collective

Lidarr is a music collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new tracks from your favorite artists and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available.

Warning

NOTICE - The Lidarr Metadata Server is recovering and rebuilding the cache which is impacting adding artists, library imports, etc. Please follow GHI 5498 or see Discord for details.

How to install Lidarr

Install Lidarr with Docker

Docker
services:
  lidarr:
    image: lscr.io/linuxserver/lidarr:latest
    environment:
      - LIDARR__SERVER__PORT=8686
      - LIDARR__SERVER__URLBASE=/lidarr
      - LIDARR__POSTGRES__HOST=postgres
      - LIDARR__POSTGRES__USER=lidarr
      - LIDARR__POSTGRES__PASSWORD=lidarr_password
      - LIDARR__POSTGRES__MAINDB=lidarr

Third-party images only (LinuxServer.io, hotio); the project recommends one shared data volume and consistent paths with your download client.

How to configure Lidarr

  • LIDARR__APP__INSTANCENAMEInstance name shown in the browser tab and used as the Syslog application name
  • LIDARR__APP__THEMEUI theme
  • LIDARR__APP__LAUNCHBROWSERWhether Lidarr opens a browser window on startup
  • LIDARR__AUTH__APIKEYAPI key
  • LIDARR__AUTH__ENABLEDEnable authentication

Lidarr releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

I locked myself out of Lidarr — how do I reset the login?

Stop Lidarr, open config.xml in the AppData directory and remove the AuthenticationMethod entries, then start it again; the UI opens without a password and prompts you to set a new login.

Which authentication methods are available?

Forms is the built-in username/password login page and is recommended; the External method hands authentication to a reverse proxy such as Authelia, Authentik or nginx auth and is set only in the config file. Basic auth was removed in v3.0.0 and converts to Forms.

Does Lidarr integrate with Plex, Emby or Jellyfin?

Not directly — media servers just read the same library folder Lidarr writes to, and the only wiring is an optional on-import/on-rename custom script that calls the server's API to refresh that folder.

Which download clients does Lidarr support?

Usenet clients include SABnzbd, NZBGet, NZBVortex, Pneumatic, Synology Download Station and a usenet blackhole folder; torrent clients include qBittorrent, Transmission, Deluge, rTorrent/ruTorrent, uTorrent, Vuze, Flood, Aria2 and a torrent blackhole folder.

Does Lidarr download lyrics, liner notes, or other extras?

No, by design: it fetches, tags and organises the release's audio files only, so lyrics have to come from a tag-aware companion tool such as beets or MusicBrainz Picard.

What audio formats does Lidarr support?

It recognises .mp2, .mp3, .m4a/.m4b/.m4p, .ogg/.oga, .opus, .wma, .wav, .wv, .flac, .ape and .aif/.aiff/.aifc files; other extensions are invisible to it. Only FLAC, APE, WavPack, WAV and WMA have named quality definitions.

Why does Lidarr only show studio albums, how do I find singles or EPs?

The default metadata profile includes only studio albums; change its Album Types and Release Statuses in Settings → Profiles → Metadata Profiles to see singles, EPs, live albums and compilations.

Why doesn't artist X show up in search?

Usually a name variant mismatch (Lidarr searches MusicBrainz primary names, so search by MBID instead), the artist missing from MusicBrainz, or every release typed as unknown so the metadata profile filters them out.

How do I update Lidarr?

Pick a branch under Settings → General → Updates: master is the stable default, develop is beta and nightly is alpha. Native installs update from System → Updates, while Docker installs are updated by re-pulling the image tag.

More in Media Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…