
Forums
Talk to Sonarr developers and other users, we are here to help.
See all your upcoming episodes in one convenient location.
Find all the releases, choose the one you want and send it right to your download client.
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.
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.
C:\ProgramData\NzbDrone
, which will be automatically converted to C:\ProgramData\Sonarr
.
It's advisable to make a backup of the v2 data first.
Download the Windows Installer with the following link and execute it.
Download Windows Installer
Browse to http://localhost:8989
to start using Sonarr.
It is possible to install Sonarr manually using the .zip download. However in that case you must manually deal with dependencies, installation and permissions.
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
.
~/.config/NzbDrone
to store the application data.
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
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
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/debian buster main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
sudo apt install sonarr
Browse to http://localhost:8989
to start using Sonarr.
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.
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.
You can follow the Docker guide to install Sonarr as a Docker container instead.
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
.
~/.config/NzbDrone
to store the application data.
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
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
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 2009837CBFFD68F45BC180471F4F90DE2A9B4BF8
echo "deb https://apt.sonarr.tv/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/sonarr.list
sudo apt update
sudo apt install sonarr
Browse to http://localhost:8989
to start using Sonarr.
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.
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.
You can follow the Docker guide to install Sonarr as a Docker container instead.
The Arch Linux User Repository offers a sonarr-phantom package that can be installed manually or using your favorite AUR helper.
/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.
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
sudo systemctl daemon_reload
sudo systemctl enable --now sonarr
Browse to http://localhost:8989
to start using Sonarr.
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.
You can follow the Docker guide to install Sonarr as a Docker container instead.
A generic download is available for linux, but dependencies, installation and permissions will need to be done manually.
Download Linux .tar.gzThe easiest way to install Sonarr on macOS is to use the App archive with the steps described below.
~/.config/NzbDrone
to store the application data, this will be migrated to ~/.config/Sonarr
.Open the archive and drag the Sonarr icon to your Application folder.
Open Sonarr.app in your Application folder.
Browse to http://localhost:8989
to start using Sonarr.
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.
You can follow the Docker guide to install Sonarr as a Docker container instead.
A generic download is available for linux, but dependencies, installation and permissions will need to be done manually.
Download Linux .tar.gz
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.
/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.
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).
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 and Docker Guide wiki article.
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.
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 doesn't specify any default volumes, besides /config
. Images are automatically updated 2x in 1 hour if upstream changes are found.
Read the instructions on how to install the image.