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.

Sonarr logo

Self-host Sonarr

v4.0.20.3014

Automatic TV episode grabber for Usenet and BitTorrent

ReleaseOpen SourceGPL-3.0
paru -S sonarr-bin
Updated2 months ago
LanguageC#
Setup difficultyModerate
ThemeDark mode
Stars
17 711
Rating
4.0 (1)
Port
8989 (Sonarr web UI / API)
Docker
ghcr.io/linuxserver/sonarr
Series detail page with episode listQuality profile editorNotification settings screenSeries library in poster viewSeries library in table viewSeries library overview viewCalendar of upcoming episodesManual search results for a releaseBlocked releases listUpdates screen showing recent episode activity

What is Sonarr?

Sonarr is a PVR — a personal video recorder for TV shows — aimed at people who grab episodes over Usenet or torrents. It watches several indexer RSS feeds at once, matches newly posted releases against the episodes you monitor, then imports, sorts and renames the files into your library. It can re-grab an episode when a higher quality format turns up, blocks releases that fail (passworded packs, missing repair blocks) and moves on to the next candidate automatically, and offers manual search when you want to pick a release yourself or see why nothing downloaded. Existing folders can be scanned so missing episodes are caught up, renaming is fully configurable, and specials plus multi-episode releases are handled. Download clients SABnzbd and NZBGet are integrated directly, and Kodi and Plex get notifications, library refreshes and metadata. The browser UI runs on port 8989 and adds an upcoming-episode calendar, several library views, editable quality profiles, light/dark themes and a built-in updater. Login is mandatory since v4. Self-hosting options: Windows installer, a Debian/Ubuntu shell script, Arch/AUR, Gentoo, FreeBSD packages, a macOS app archive, or community container images from hotio and linuxserver.io (no official image ships from the project); settings live in an AppData directory backed by an SQLite database and a config.xml file.

Sonarr alternatives

Should you self-host Sonarr?

Sonarr scores 80/100 on selfhost.directory (how scoring works) and ranks #1 of 141 in Media Management. It has 17 711 GitHub stars, +715 in the last 30 days.

It shipped 34 stable releases in the past year. The latest, v5.0.0.2941, came out on 3 November 2026. New versions land roughly every 2 days.

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

Its closest alternative on selfhost.directory is seerr (77/100, 13 228 stars). Sonarr scores higher overall. See Sonarr vs seerr side by side.

Features

  • Automatic failed download handling
  • Automatic Quality Upgrades
  • Built-in updater
  • Configurable episode renaming
  • Customizable quality profiles
  • Download client integration
  • Existing library import
  • Manual Search
  • Media server notifications
  • REST API
  • RSS feed monitoring for new episodes
  • Specials and multi-episode release support
  • Upcoming episode calendar
  • Web UI

Sonarr README

Sonarr Sonarr

Translated Backers on Open Collective Sponsors on Open Collective Mega Sponsors on Open Collective

Sonarr is a PVR for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new episodes of your favorite shows 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.

Getting Started

How to install Sonarr

Install Sonarr with Docker

ghcr.io/hotio/sonarr:release

hotio doesn't specify any default volumes, besides /config. Images are automatically updated multiple times per hour if upstream changes are found. Read the instructions on how to install the image.

ghcr.io/linuxserver/sonarr:latest

linuxserver.io is one of the most prolific and popular Docker image maintainers.

The Sonarr team does not offer an official Docker image; these third-party images are maintained by hotio and linuxserver.io. Most containers mount the data directory at /config.

Sonarr releases & version history

@ Every self-hosted release, weekly

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

FAQ

Can I put Sonarr behind a VPN?

Not recommended: VPN provider IP ranges cause rate limits, DDOS protection and bans from the services Sonarr relies on, which can make the app unusable.

Why does Sonarr refresh series information so frequently?

Every 12 hours it pulls updated episode, air-date and status data from the TVDb proxy and rescans folders for files added or deleted outside Sonarr. The rescan after refresh is the setting to tune if the task causes heavy I/O.

How do I access Sonarr from another computer?

By default Sonarr only listens on localhost on Windows; running it as administrator once registers it and opens the firewall port so other machines on the network can reach it (re-run it if you change the port).

Episode progress - how is it calculated?

The episode count covers aired and monitored episodes plus any that have a file, while the file count only counts episodes you actually have on disk.

I see that feature/bug X was fixed, why can I not see it?

Sonarr has a develop branch for pre-release testing and a main branch that is released periodically once develop is stable, so develop-only fixes are not in the stable build.

Why are there two files? | Why is there a file left in downloads?

That is expected: completed downloads stay in the download client so they can keep seeding, and Sonarr hardlinks (or copies if hardlinks are unsupported) them into your media folder. Removing originals happens only with Completed Download Handling enabled once seeding is done.

Help I have locked myself out

Authentication is required in v4, so to reset a forgotten login you stop Sonarr, delete the AuthenticationMethod line from config.xml in the AppData directory and restart; the web UI then asks you to set a new password and method.

How do I Backup/Restore my Sonarr?

Use System => Backup in the UI to create a zip, or stop Sonarr and copy the AppData directory. Restoring to a different operating system is not supported because paths differ; a zip backup is restored through System => Backup => Restore Backup.

How do I change from the Windows Service to a Tray App?

Shut Sonarr down, run serviceuninstall.exe from the Sonarr directory, then run Sonarr.exe once as administrator so it gets permissions and firewall rules; optionally put a shortcut in the startup folder.

How are possible downloads compared?

Quality is the main deciding factor, followed by custom format score, protocol, episode and episode number, indexer priority, seeds/peers or age, and size. Repacks and PROPERs rank above the same quality without them.

How does Sonarr find episodes?

It does not hunt for old or missing files directly; instead it repeatedly queries your indexers and trackers for newly posted releases and downloads the ones matching monitored episodes or upgrade goals. To catch up on the past you trigger a search yourself, e.g. "Start search for missing" when adding a show.

More in Media Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…