Sonarr is an internet PVR for Usenet and Torrents.

Notifications and fully customizable quality profiles.

Multiple Series views.

Built-in updater. See what's new without leaving the comfort of the app.

Sonarr is an internet PVR for Usenet and Torrents.

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 block the release and try another one until it finds one that works.

Download Sonarr

Package maintainers: Team Sonarr
Introduction

Sonarr is supported natively on Windows. Sonarr can be installed as Windows Service or System Tray Application.

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 (X:\ mapped drives or \\server\share UNC paths) 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 is supported on Windows 8.1 and Server 2012 or later. Pre-release or earlier versions of Windows are not supported.

Updating Sonarr v3 to v4

Sonarr will automatically convert an existing Sonarr installation. It's advisable to make a backup of the v3 data first.

1Install Sonarr

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

2View Sonarr

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

Manual Install

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

Package maintainers: Team Sonarr
Introduction

The installation process described here utilizes an installation shell script. The script will configure the required systemd unit to auto-start Sonarr. It'll deploy the binaries in /opt/Sonarr and the configuation data will be stored in /var/lib/sonarr.

Updating Sonarr v3 to v4

The Sonarr v4 package overwrites v3's systemd unit if present. It's advisable to make a backup of the v3 data first and uninstall the previous sonarr package.
1Install Sonarr

Run one of the below commands as root.

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.
If you need to correct these after installation, please re-run the installation script.
curl
curl -o- https://raw.githubusercontent.com/Sonarr/Sonarr/develop/distribution/debian/install.sh | sudo bash
wget
wget -qO- https://raw.githubusercontent.com/Sonarr/Sonarr/develop/distribution/debian/install.sh | sudo bash
2View 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 manally using a .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions. You will need to download the correct package for your system.

ARM (ARM, armf, and armhf)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm
ARM64 (arm64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm64
AMD64 (x64) (amd64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=x64
Docker container

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

Package maintainers: Team Sonarr
Introduction

The installation process described here utilizes an installation shell script. The script will configure the required systemd unit to auto-start Sonarr. It'll deploy the binaries in /opt/Sonarr and the configuation data will be stored in /var/lib/sonarr.

Updating Sonarr v3 to v4

The Sonarr v4 package overwrites v3's systemd unit if present. It's advisable to make a backup of the v3 data first and uninstall the previous sonarr package.
1Install Sonarr

Run one of the below commands as root.

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.
If you need to correct these after installation, please re-run the installation script.
curl
curl -o- https://raw.githubusercontent.com/Sonarr/Sonarr/develop/distribution/debian/install.sh | sudo bash
wget
wget -qO- https://raw.githubusercontent.com/Sonarr/Sonarr/develop/distribution/debian/install.sh | sudo bash
2View 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 manally using a .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions. You will need to download the correct package for your system.

ARM (ARM, armf, and armhf)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm
ARM64 (arm64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm64
AMD64 (x64) (amd64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=x64
Docker container

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

Package maintainers: degeberg, fryfrog
Introduction

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

Updating Sonarr v3 to v4

Sonarr will convert an existing Sonarr database if found during startup. Of course, it is always advisable to make a backup first.

1Install 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 paru to install the sonarr package:

paru -S sonarr

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.

Package maintainers: xartin, candrews
Introduction

Gentoo Linux includes sonarr so it can be installed using Gentoo portage.

1Install Sonarr
emerge www-apps/sonarr
2Start Sonarr
systemctl daemon-reload
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.

Package maintainers: mvanbaak
Introduction

Sonarr can be installed using the FreeBSD Sonarr Port.

1Install Sonarr

Install the port with:

pkg install sonarr

2Start Sonarr

Start the service:

sysrc sonarr_enable=YES
service sonarr start

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 v4 for any other distribution that the ones already listed.

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

ARM (ARM, armf, and armhf)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm
ARM64 (arm64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=arm64
AMD64 (x64) (amd64)
https://services.sonarr.tv/v1/download/main/latest?version=4&os=linux&arch=x64
Package maintainers: Team Sonarr
Introduction

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

Updating Sonarr v3 to v4

Sonarr will convert an existing Sonarr database if found during startup. Of course, it is always advisable to make a backup first.
1Download App package
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.
3Self-sign Sonarr

Open Terminal and run

codesign --force --deep -s - /Applications/Sonarr.app && xattr -rd com.apple.quarantine /Applications/Sonarr.app
4Start Sonarr

Open Sonarr.app in your Application folder.

5View Sonarr

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

Manual Install

It is possible to install Sonarr manually using the macOS ARM or macOS Intel .tar.gz downloads. 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.

A Sonarr package is maintained by SynoCommunity
Please contact us if you wish to include the appropriate install instructions on this page.
The Sonarr Qnap port is being maintained by the qnap forum community.
Please contact us if you wish to include the appropriate install instructions on this page.
Please contact us if you wish to port Sonarr for any other NAS that the ones already listed.

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

Download Linux .tar.gz
Package maintainers: linuxserver, hotio
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.

Updating Sonarr v3 to v4

Most docker containers use /config volume to mount the data directory and supply that path to Sonarr as parameter. Sonarr will convert the given directory on startup if an existing database is found. Of course, it is always advisable to make a backup 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.Show.S01E01/, but in the Sonarr container that might be at /downloads/My.Show.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 Series 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 and Docker Guide wiki article.

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.

  • ghcr.io/hotio/sonarr:release

    hotio doesn't specify any default volumes, besides /config. Images are automatically updated multiple times per hour if upstream changes are found. Read the instructions on how to install the image.

  • ghcr.io/linuxserver/sonarr:latest

    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 optional default volumes such as /tv and /downloads. The default volumes are not optimal nor recommended. Our recommendation is to use a single volume for the data, as mentioned above.

Please contact us if you wish to port Sonarr for any other platform that the ones already listed.

Support