Skip to main content

Sonarr v2 aka "Stable"

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.

Initial Setup#

Installing Sonarr is easy. Simply issue the following command from SSH:

sudo box install sonarr

This command will configure sonarr for your user. Sonarr is installed via an apt repository, thus the easiest way to keep it up to date is by issuing the command apt update && apt upgrade. The sonarr base files will be located in /opt/nzbdrone

How to Access#

Once setup, sonarr will be available at the link https://<>/sonarr

Service Management#

Service status for sonarr is handled by systemd. Despite the service being enabled for multi-user usage, Sonarr itself has not been configured for usage on more than one user account with swizzin. Regardless, as a multi-user service, you must append the username of the service you need to modify follow the @ sign. The systemd service file resides at

sudo systemctl start sonarr@<username>


Out of the box, Sonarr comes with very little configuration. Following are some basic tasks to help get your client up and running:

Add a new show (and your first root directory)#

  1. At the top, click series.
  2. Click the button + Add Series
  3. Type the name of the show you want to add
  4. Under Path, choose Add a new path. Enter the path for the folder you wish to add your Sonarr shows to and click the green check-mark to add the directory.
  • e.g. "/home/<username>/media/TV Shows"
  1. Change the other settings to your own needs
  2. Click the green + to add the show.

Connect download clients#

To add a download client, go to Settings > Download Client. Make sure Advanced Settings are shown and click Add Client.

Name: rTorrent
rTorrent host:
Port: 443
URL Path: /rutorrent/plugins/httprpc/action.php
Username: <your username>
Password: <your password>
Add label to torrent: TV (or anything else you desire)
Optional - Downloaded files location: <custom directory>

Add an indexer with Jackett#

Sonarr only supports a few trackers out of the box, but the indexers can be expanded by using the application Jackett. To add an indexer with Jackett, use the following steps.


By default, when receiving the torznab feed from Jackett, it will need to be modified to be connected with the application. The default link looks like:


We need to edit this link to remove https and add the port number. Thus, if your port number was 12345, your edited URL would look like this:

  1. Go to Settings > Indexers and click + to add a new indexer.
  2. Under Torrent choose Torznab
  3. Use the settings:
Name: <tracker name>
URL: <click copy torznab feed in jackett and modify as per above>
API: <copy and paste from jackett UI>
  1. Click Test. If all is good, click Save.

Other tasks#

You may wish to further alter your setup by setting quality profiles or setting up post-processing so that media is automatically transferred to your Sonarr library when your torrents are completed. If you need further help, you can refer to the Sonarr Wiki.

Switching between v2 and v3#

Upgrading to Sonarr v3#

You can upgrade to Sonarr v3 by running either box install sonarrv3 or box upgrade sonarr (They do the exact same thing). Please check the migration chapter for more information.

Downgrading from Sonarr v3#

Like above, please check the downgrading chapter in v3 docs for more information.