Self-host Sonarr
v4.0.20.3014Automatic TV episode grabber for Usenet and BitTorrent
paru -S sonarr-bin- Stars
- 17 711
- Rating
- 4.0 (1)
- Port
- 8989 (Sonarr web UI / API)
ghcr.io/linuxserver/sonarrWhat 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
autobrrSelf-hosted and open-source: watches tracker IRC channels plus RSS, Torznab and Newznab feeds, filters each release, then pushes it to your torrent or Usenet clients.Compareautobrr with Sonarr
MediaManagerSelf-hosted, open-source media manager for TV and movie libraries: discover releases, score them, hand downloads to qBittorrent or SABnzbd, with OIDC sign-in.CompareMediaManager with Sonarr
EpiseerrEpiseerr is a self-hosted, open-source tool that automates TV episode management for Sonarr — downloading episodes as you watch and cleaning up storage automatically.CompareEpiseerr with Sonarr
WhisparrSelf-hosted adult movie manager for Usenet and BitTorrent that monitors RSS feeds, integrates with download clients and media servers, and auto-upgrades quality.CompareWhisparr with Sonarr
cli_debridSelf-hosted media automation that scrapes torrents/Usenet, uses debrid services, and organizes libraries for Plex/Jellyfin/Emby with auto quality upgrades.Comparecli_debrid with Sonarr
LidarrOpen-source, self-hosted music collection manager that watches indexer RSS feeds, grabs albums over Usenet or BitTorrent, and upgrades quality automatically.CompareLidarr with Sonarr
ProwlarrSelf-hosted, open-source indexer manager that administers torrent trackers and Usenet indexers and syncs them into your PVR apps automatically.CompareProwlarr with Sonarr
BazarrOpen-source, self-hosted subtitle manager that pairs with Sonarr and Radarr to find, download and upgrade subtitles across 60+ providers and 184 languages.CompareBazarr with Sonarr
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 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.
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
SortarrSelf-hosted open-source dashboard connecting Sonarr, Radarr, Plex, Jellyfin, and Emby to find missing media using playback data from Tautulli, Jellystat, Streamystats.
SoulbeetOpen-source, self-hosted music downloader that fetches albums and tracks from Soulseek via slskd, tags them with beets, and builds auto-discovery playlists for Navidrome.
SportarrSelf-hosted sports PVR monitors leagues, searches indexers for releases. Like Sonarr but for combat sports, football, basketball, racing and hundreds more.
spotify-to-plexSelf-hosted web app that syncs Spotify playlists to Plex, matching tracks and downloading missing songs via Lidarr, SLSKD, or Tidal. Open-source under Apache-2.0.
SpottarrSelf-hosted, open-source Spotnet client that indexes Usenet spots and serves them as a Newznab indexer for *arr media automation tools.
StashSelf-hosted, open-source media organizer in Go that indexes, tags and streams your video and image collection, with scraper metadata, plugins and DLNA.
streamsphereStreamsphere is a self-hosted, open-source media library that downloads and organizes YouTube channels, playlists, and videos with a web UI for browsing and playback.
StreamystatsSelf-hosted analytics dashboard for Jellyfin providing watch history tracking, library statistics, and AI-powered recommendations based on vector embeddings.
StremioSelf-hosted browser UI for the Stremio media center: browse addon catalogs, cast to TV, sync your library and Continue Watching with your account.
strettoOpen-source, self-hosted web music player that backs your library with YouTube and SoundCloud tracks, imports Spotify playlists, and syncs across machines.
subarrSelf-hosted open-source service coordinating subtitle coverage, audio-language verification, and Whisper transcription across Sonarr, Radarr, Bazarr, and subgen.
Subtitle ScoutSelf-hosted subtitle automation with an LLM agent that identifies media via TMDB, searches seven sources, and installs correct subtitles. One Docker container.











0 comments