Automating TV Downloads Without the Manual Grind
Managing a personal media library used to mean manually hunting for episode downloads, renaming files, and organizing folders – a process that consumed more time than the shows themselves. Sonarr solves that entirely. It is an open-source PVR (personal video recorder) application that monitors RSS feeds from Usenet indexers and torrent trackers, automatically grabs new episodes as they air, and drops renamed, properly organized files directly into your media directory. Once configured, it runs silently in the background and your library just grows.
The setup process is not complicated, but it does require a few moving parts to be connected correctly before anything works. You need Sonarr itself, a download client (either a torrent client like qBittorrent or a Usenet downloader like SABnzbd), and at least one indexer that Sonarr can pull release information from. This guide walks through all three layers and how to wire them together into a working automated pipeline.
Installing Sonarr on Your System
Sonarr supports Windows, macOS, Linux, and Docker. The Docker route is the cleanest option for most home server users because it keeps Sonarr isolated from the host system and makes updates straightforward. Pull the official Sonarr image from LinuxServer.io, which is maintained actively and includes sensible defaults. The basic Docker run command or docker-compose configuration needs three volume mounts: one for Sonarr’s config data, one pointing to your download client’s completed downloads folder, and one pointing to your final TV library folder. Getting these paths consistent across all your containers is the single most common source of broken automation.
On a bare-metal Linux install, Sonarr provides a repository-based installation through apt or yum depending on your distribution. After adding the repository and running the install, Sonarr runs as a background service and is accessible via a browser at port 8989. On Windows, the installer handles service registration automatically. Once you load the web UI for the first time, the interface walks you through a basic setup wizard that covers your media directory and authentication settings. Set a username and password – even on a home network, leaving it open is unnecessary risk.
The first configuration item worth locking in before anything else is your root folder. This is the directory where Sonarr will store and organize your TV shows. Navigate to Settings, then Media Management, and add the path to your TV library folder. Sonarr will create subfolders per show automatically using the naming convention you specify. The default naming format includes the show title, season number, episode number, and episode title – which is compatible with Plex, Jellyfin, and Emby without any additional renaming work.
Connecting Your Download Client
Sonarr does not download anything itself. It identifies releases and hands them off to a separate download client, which does the actual file retrieval. Go to Settings, then Download Clients, and add your client of choice. For qBittorrent, you need the host address, port, and credentials you configured in qBittorrent’s web UI. For SABnzbd, the same applies with the addition of your API key. Once the connection is saved, Sonarr tests it automatically and will flag any authentication or connectivity errors immediately.
A critical setting inside the download client configuration is the category or label field. When Sonarr sends a download to qBittorrent, it tags it with a specific category – “tv-sonarr” by default. qBittorrent then routes completed downloads from that category to a designated folder. Sonarr monitors that same folder for completed files, imports them to your library, and renames them. If the category and folder paths are not aligned across both applications, Sonarr will never see the finished download and the import chain breaks. Double-check that the completed download path in your download client matches exactly what Sonarr is watching.
Adding Indexers and Configuring Search
Indexers are the sources Sonarr queries when searching for episode releases. Without at least one functional indexer, Sonarr has nothing to work with. The application supports both Usenet indexers (like NZBGeek or NZBPlanet, which require paid subscriptions) and torrent indexers. For torrent-based setups, the most practical approach is running Prowlarr alongside Sonarr. Prowlarr is a separate application that aggregates dozens of public and private torrent trackers and syncs them to Sonarr automatically – meaning you manage your indexers in one place instead of adding them manually to every application in your stack.
To connect Prowlarr, go to Settings, then General in Prowlarr and copy the API key. In Sonarr, go to Settings, then Indexers, click the plus button, and select Prowlarr as the indexer type. Enter Prowlarr’s address and paste the API key. After saving, Sonarr will pull all of your configured Prowlarr indexers automatically. Any indexers you add or remove in Prowlarr will sync across without touching Sonarr’s configuration again. This approach also scales well if you later add Radarr for movies or Lidarr for music – they all connect to the same Prowlarr instance.
Quality profiles control which releases Sonarr will accept and which it will ignore. Navigate to Settings, then Profiles, and review the default options. The “HD – 720p/1080p” profile is a reasonable starting point for most users. Each profile specifies an ordered list of acceptable qualities – Sonarr will grab the first available release that meets your minimum quality threshold, but if a better quality version appears later, it can be configured to automatically upgrade. The cutoff setting is where that logic lives: set your cutoff to 1080p and Sonarr will keep searching for a 1080p copy even after downloading a 720p version, then replace the file automatically once the better copy is found.
Delay profiles add another layer of control that is easy to overlook but genuinely useful. A delay profile tells Sonarr to wait a set number of minutes or hours before grabbing a release. The reason this matters: immediately after an episode airs, the first available releases are often low-quality encodes from unreliable sources. Waiting 30 to 60 minutes gives higher-quality releases time to appear in the indexer feeds. For Usenet, delays are typically shorter because retention and release quality are more consistent. For public torrent trackers, a longer delay reduces the chance of downloading a broken or mislabeled file.
Adding a show to Sonarr is the final step that makes everything operational. Click the plus button on the Series page, search for the show name, select it from the results (Sonarr pulls metadata from TVDB), choose your quality profile and root folder, and decide whether to monitor all seasons or just future episodes. If you select “Start search for missing episodes,” Sonarr immediately queries your indexers for existing episodes. For a currently airing show, Sonarr will then watch for each new episode as it releases and download it without any further input. The show folder, season subfolders, and properly named episode files all get created automatically.
One thing that trips up new users is the difference between monitoring and searching. A show can be added and monitored without triggering an immediate search – monitoring just means Sonarr will grab future releases as they appear in RSS feeds. The RSS sync interval, set under Settings, then General, defaults to every few minutes. If an episode drops while Sonarr is between sync cycles, it may take a short while before the grab fires. For time-sensitive downloads, the manual search button on any episode gives you immediate results from all connected indexers, ranked by quality and source.
