Works great and looks even better doing it.

Notifications and fully customizable quality profiles.

Multiple Series views.

Frequent updates. See what's new without leaving the comfort of the app.

Features

Calendar

See all your upcoming episodes in one convenient location.

Manual Search

Find all the releases, choose the one you want and send it right to your download client.

Automatic Failed Download Handling

Sonarr makes failed downloads a thing of the past. Password protected releases, missing repair blocks or virtually any other reason? no worries. Sonarr will automatically blacklist the release and tries another one until it finds one that works.

Download

Linux

Automatic Updates

Use your package manager

INSTRUCTIONS

macOS

Automatic Updates

INSTRUCTIONS

Download v3 Beta

Introduction

Sonarr is supported natively on Windows. Sonarr can be installed on Windows as Windows Service or system tray application.

A Windows Service runs even when the user is not logged in, but special case must be taken since Windows Services cannot access network drives (\\server\share or X:\ mapped drives) without special configuration steps.
It's therefore advisable to install Sonarr as a system tray application if the user does not need to log out, the option to do so is provided during the installer.

Sonarr v3 no longer supports Windows XP. At this time Windows 7 should still work, but we will not maintain Windows 7 support.

Sonarr v2 migration

Sonarr v3 will automatically convert the existing Sonarr v2 installation. Sonarr v2 stored it's database in C:\ProgramData\NzbDrone, which will be automatically converted to C:\ProgramData\Sonarr. It's advisable to make a backup of the v2 data first.
1Install Sonarr

Download the Windows Installer with the following link and execute it.

Download Windows Installer
2View Sonarr

Browse to http://localhost:8989 to start using Sonarr.

Manual Install

It is possible to install Sonarr manually using the .zip download. However in that case you must manually deal with dependencies, installation and permissions.

Introduction

The installation process described here utilizes Debian's apt package manager. The package will configure the required systemd unit to auto-start Sonarr. It'll deploy the binaries in /usr/lib/sonarr/bin and the configuation data will be stored in /var/lib/sonarr.

Sonarr v2 migration

The Sonarr v3 package will attempt to automatically migrate an existing Sonarr v2 installation, but it will only do so for installations utilizing systemd. It's advisable to make a backup of the v2 data first.
Sonarr v2 used the user's home directory ~/.config/NzbDrone to store the application data.
1Optional: Mono and MediaInfo dependencies
Debian includes functioning versions of Mono and MediaInfo in it's default repositories. However newer updates are available in the vendors individual repositories. For Sonarr to function optimally it may be necessary to configure those repositories.
  • Add the Mono repository. You do not need to install mono itself.
  • Add the MediaInfo repository.
2Add the Sonarr repository
Note: the packages should work on newer Debian versions too but we only provide packages for the ones listed below.
Debian 8 "jessie" (i386, amd64)
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/debian jessie main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
Debian 9 "stretch" (i386, amd64)
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/debian stretch main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
3Install Sonarr
During the installation, you will be asked which user and group Sonarr must run as. It's important to choose these correctly to avoid permission issues with your media files. We suggest you keep at least the group name identical between your download client(s) and Sonarr.
sudo apt install sonarr
4View Sonarr

Browse to http://localhost:8989 to start using Sonarr.

(Replace 'localhost' with your server IP if you're connecting remotely)
Manual Install

It is possible to install Sonarr manually using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Debian package channels

The Debian packages provided are used to configure the systemd unit, adding users and permissions. However the built-in updater is used for subsequent application updates. The package itself is only updated if changes are made to the required dependencies or install/configuration scripts.

For advanced users the alternative *-master and *-develop apt repo distributions are available. In these channels the built-in updater is disabled and apt must be used to install updates.

Docker container

You can follow the Docker guide to install Sonarr as a Docker container instead.

Introduction

The installation process described here utilizes Ubuntu's apt package manager. The package will configure the required systemd unit to auto-start Sonarr. It'll deploy the binaries in /usr/lib/sonarr/bin and the configuation data will be stored in /var/lib/sonarr.

Sonarr v2 migration

The Sonarr v3 package will attempt to automatically migrate an existing Sonarr v2 installation, but it will only do so for installations utilizing systemd. It's advisable to make a backup of the v2 data first.
Sonarr v2 used the user's home directory ~/.config/NzbDrone to store the application data.
1Optional: Mono and MediaInfo dependencies
Ubuntu includes functioning versions of Mono and MediaInfo in it's default repositories. However newer updates are available in the vendors individual repositories. For Sonarr to function optimally it may be necessary to configure those repositories.
  • Add the Mono repository. You do not need to install mono itself.
  • Add the MediaInfo repository.
2Add the Sonarr repository
Note: the packages should work on newer Ubuntu versions too but we only provide packages for the ones listed below.
Ubuntu 16.04 "xenial" (i386, amd64)
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/ubuntu xenial main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
Ubuntu 18.04 "bionic" (i386, amd64)
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/ubuntu bionic main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
3Install Sonarr
During the installation, you will be asked which user and group Sonarr must run as. It's important to choose these correctly to avoid permission issues with your media files. We suggest you keep at least the group name identical between your download client(s) and Sonarr.
sudo apt install sonarr
4View Sonarr

Browse to http://localhost:8989 to start using Sonarr.

(Replace 'localhost' with your server IP if you're connecting remotely)
Manual Install

It is possible to install Sonarr manually using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Ubuntu package channels

The Ubuntu packages provided are used to configure the systemd unit, adding users and permissions. However the built-in updater is used for subsequent application updates. The package itself is only updated if changes are made to the required dependencies or install/configuration scripts.

For advanced users the alternative *-master and *-develop apt repo distributions are available. In these channels the built-in updater is disabled and apt must be used to install updates.

Docker container

You can follow the Docker guide to install Sonarr as a Docker container instead.

Introduction

The Arch Linux User Repository offers a sonarr-phantom package that can be installed manually or using your favorite AUR helper.

Sonarr v2 migration

The existing sonarr AUR packages already used /var/lib/sonarr to store the Sonarr database. Sonarr v3 will convert that directory automatically on startup. It's advisable to make a backup of the v2 data first.
1Install Sonarr

An aur helper can install sonarr-phantom and its dependencies easily, or follow the AUR Installing Packages wiki for manual installation.

For example, to use yay to install the sonarr-phantom package:

yay -S sonarr-phantom

2Start Sonarr
sudo systemctl daemon_reload
sudo systemctl enable --now sonarr
3View Sonarr

Browse to http://localhost:8989 to start using Sonarr.

(Replace 'localhost' with your server IP if you're connecting remotely)
Manual Install

It is possible to install Sonarr manually from upstream using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Docker container

You can follow the Docker guide to install Sonarr as a Docker container instead.

Please contact us if you wish to port Sonarr v3 Beta for any other distribution that the ones already listed.
Sonarr v2 is supported by various third-parties on other platforms and we prefer to coordinate the port of v3.

A generic download is available for linux, but dependencies, installation and permissions will need to be done manually.

Download Linux .tar.gz
Introduction

The easiest way to install Sonarr on macOS is to use the App archive with the steps described below.

Sonarr v2 migration

The Sonarr v3 package will attempt to automatically migrate an existing Sonarr v2 database. Sonarr v2 used the user's home directory ~/.config/NzbDrone to store the application data, this will be migrated to ~/.config/Sonarr.
It's advisable to make a backup of the v2 data before installing v3.
1Download App package
Download macOS App
2Install App

Open the archive and drag the Sonarr icon to your Application folder.

In macOS 10.12+ Gatekeeper App Translocation will prevent Sonarr from updating if it's being run directly from the download location. Therefore it MUST be moved to the Application folder.
3Start Sonarr

Open Sonarr.app in your Application folder.

During startup it may ask you to install the Mono Runtime if an appropriate version is not already installed.
4View Sonarr

Browse to http://localhost:8989 to start using Sonarr.

Manual Install

It is possible to install Sonarr manually using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Docker container

You can follow the Docker guide to install Sonarr as a Docker container instead.

The Sonarr v2 Synology package was provided by SynoCommunity. No v3 Synology package is currently available.
Please contact us if you wish to maintain a v3 package so that we can include the appropriate install instructions.
The Sonarr v2 Qnap port was maintained by the qnap forum community.
Please contact us if you wish to maintain a v3 package so that we can include the appropriate install instructions.
Please contact us if you wish to port Sonarr v3 Beta for any other nas that the ones already listed.
Sonarr v2 is supported by various third-parties on other platforms and we prefer to coordinate the port of v3.

A generic download is available for linux, but dependencies, installation and permissions will need to be done manually.

Download Linux .tar.gz
Introduction

The Sonarr team does not offer an official Docker image. However, a number of third parties have created and maintain their own.
These instructions provide generic guidance that should apply to any Sonarr Docker image.

Sonarr v2 migration

Most docker containers use /config volume to mount the data directory and supply that path to Sonarr as parameter. Sonarr v3 will convert the given directory on startup if a Sonarr v2 database is found. It's advisable to make a backup of the v2 data first.
1Avoid common pitfalls
Volumes and Paths

There are two common problems with Docker volumes: Paths that differ between the Sonarr and download client container and paths that prevent fast moves and hard links.
The first is a problem because the download client will report a download's path as /torrents/My.Series.S01E01/, but in the Sonarr container that might be at /downloads/My.Series.S01E01/. The second is a performance issue and causes problems for seeding torrents. Both problems can be solved with well planned, consistent paths.

Most Docker images suggest paths like /tv and /downloads. This causes slow moves and doesn't allow hard links because they are considered two different file systems inside the container. Some also recommend paths for the download client container that are different from the Sonarr container, like /torrents.
The best solution is to use a single, common volume inside the containers, such as /data. Your TV shows would be in /data/TV, torrents in /data/downloads/torrents and/or usenet downloads in /data/downloads/usenet.

If this advice is not followed, you may have to configure a Remote Path Mapping in the Sonarr web UI (Settings › Download Clients).

Ownership and Permissions

Permissions and ownership of files is one of the most common problems for Sonarr users, both inside and outside Docker. Most images have environment variables that can be used to override the default user, group and umask, you should decide this before setting up all of your containers. The recommendation is to use a common group for all related containers so that each container can use the shared group permissions to read and write files on the mounted volumes.
Keep in mind that Sonarr will need read and write to the download folders as well as the final folders.

For a more detailed explanation of these issues, see The Best Docker Setup wiki article on Reddit /r/usenet.

2Install Sonarr

To install and use these Docker images, you'll need to keep the above in mind while following their documentation. There are many ways to manage Docker images and containers too, so installation and maintenance of them will depend on the route you choose.

  • lsiodev/sonarr-preview

    linuxserver.io is one of the most prolific and popular Docker image maintainers. They also maintain images for most of the popular download clients as well. LinuxServer specifies a couple of default volumes such as /tv and /downloads. Our recommendation is to use a single volume for the data, as mentioned above.

  • hotio/suitarr

    hotio uses tags for each software it supports instead of individual Docker images. Read the instructions on how to install the image.

Please contact us if you wish to port Sonarr v3 Beta for any other platform that the ones already listed.
Sonarr v2 is supported by various third-parties on other platforms and we prefer to coordinate the port of v3.

Support