Debian
ArchLinux
GentooForums
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.
Sonarr can be installed as system tray application or Windows Service. A system tray application is started after the user logs in and is visible as an icon on the taskbar system tray.
A Windows Service runs even when the user is not logged in, but special care must be taken since Windows Services cannot access network drives (\\server\share or X:\ mapped drives) without special configuration steps.
Additionally the Windows Service runs under the 'Local Service' account, by default this account does not have permissions to access your user's home directory unless permissions have been assigned manually. This is particularly relevant when using download clients that are configured to download to your home directory.
It's therefore advisable to install Sonarr as a system tray application if the user can remain logged in. The option to do so is provided during the installer.
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.
Sonarr v2 ran under the System account, which has far too many privileges. Sonarr v3 runs under the Local Service account, and will not have access to user's home directories. This may lead to unexpected behavior when you're using a download client thats configured to download to your home directory. If this applies to you, please install Sonarr to run as system tray application instead.
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 updatesudo 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 updatesudo 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 updatedpkg-reconfigure sonarr. See debconf for more information.
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 *-main 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 updatesudo 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 updatesudo 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 updatedpkg-reconfigure sonarr. See debconf for more information.
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 *-main 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 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.sonarr-phantom has now been superceded by sonarr.
An aur helper can install sonarr and its dependencies easily, or follow the AUR Installing Packages wiki for manual installation.
For example, to use yay to install the sonarr package:
yay -S sonarrsudo 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.
The Gentoo Linux Ebuild Overlay offers a sonarr package that can be installed using Gentoo portage.
The easiest method to add this overlay for sonarr to any Gentoo Linux install is using eselect repository to provide sonarr package install files.
For example,
emerge eselect-repository dev-vcs/git
emerge --sync usenet-overlay
emerge sonarrsystemctl daemon-reload
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 /data volume, 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.