Check out the FAQ, API documentation and other guides
See all your upcoming movies in one convenient location.
Find all the releases, choose the one you want and send it right to your download client.
Radarr makes failed downloads a thing of the past. Password protected releases, missing repair blocks or virtually any other reason? no worries. Radarr will automatically blacklist the release and tries another one until it finds one that works.
Ensure you get the right release every time! Custom Formats allows fine control over release prioritization and selection. As simple as a single preferred word or as complex as you want with multiple criteria and regex.
Radarr is supported natively on Windows. Radarr 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 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.
'Local Service' also generally has very limited permissions. It's therefore advisable to install Radarr as a system tray application if the user can remain logged in. The option to do so is provided during the installer.
C:\ProgramData\Radarr, which will be automatically converted to v3 on startup.
Download the Windows Installer with the following link and execute it.Download Windows x64 Installer Download Windows x86 Installer
to start using Radarr.
It is possible to install Radarr manually using the x64 .zip download. However in that case you must manually deal with dependencies, installation and permissions.
/var/lib/radarrto store the Radarr database. Radarr v3 will convert that directory automatically on startup.
An aur helper can install radarr and its dependencies easily, or follow the AUR Installing Packages wiki for manual installation.
For example, to use yay to install the radarr package:
yay -S radarr
sudo systemctl daemon-reload sudo systemctl enable --now radarr
to start using Radarr.
The community has put together an Installation Guide to help you install this on Debian or Ubuntu.
Generic .tar.gz downloads are available for linux, but dependencies, installation and permissions will need to be done manually.
The easiest way to install Radarr on macOS is to use the App archive with the steps described below.
~/.config/Radarrto store the application data which v3 also uses.
Open the archive and drag the Radarr icon to your Application folder.
Open Radarr.app in your Application folder.
to start using Radarr.
A generic download is available for linux, but dependencies, installation, and permissions will need to be done manually.Download Linux .tar.gz
The Radarr 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 Radarr Docker image.
/configvolume to mount the data directory and supply that path to Radarr as parameter. Radarr v3 will convert the given directory on startup if a Radarr v0.2 database is found.
There are two common problems with Docker volumes: Paths that differ between the Radarr 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.Movie.2018/, but in the Radarr container that might be at
/downloads/My.Movie.2018/. 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
/downloads. This causes slow moves and doesn't allow hard links because they
are considered two different file systems
the container. Some also recommend paths for the download client container that are different from the Radarr container, like
The best solution is to use a single, common volume inside the containers, such as
Your Movies would be in
/data/Movies, torrents in
and/or usenet downloads in
If this advice is not followed, you may have to configure a Remote Path Mapping in the Radarr web UI (Settings › Download Clients).
Permissions and ownership of files is one of the most common problems for Radarr 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 Radarr 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.
doesn't specify any default volumes, besides
/config. Images are automatically updated multiple times in an hour if upstream changes are found. Hotio also builds our Pull Requests which may be useful for testing.
on how to install the image.
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
/downloads. The default volumes are not optimal nor recommended. Our recommendation is to use a single volume for the data, as mentioned above.