Debian / Ubuntu
Note: Raspberry Pi OS and Raspbian are both flavors of Debian
Easy Install
For the Debian / Ubuntu / Raspbian beginners there isn’t an Apt Repository or Deb package.
If you want an easy life, follow this community provided and maintained Easy Install
script for a base Debian (Raspbian / Raspberry Pi OS) / Ubuntu install.
For the official installation instructions that are ‘Hands on’ follow the Debian / Ubuntu Hands on Install steps further below.
Please see the *Arr Community Installation Script
Radarr uses a bundled version of ffprobe for media file analysis and does not require ffprobe or ffmpeg to be installed on the system. If Radarr says Ffprobe is not found this can typically be fixed with a reinstall.
Debian / Ubuntu Hands on Install
You’ll need to install the binaries using the below commands.
The steps below will download Radarr and install it into
/opt
Radarr will run under the userradarr
and groupmedia
;media
is the commonly suggested group to run the *Arrs, download clients, and media server under.
Radarr’s configuration files will be stored in/var/lib/radarr
- Ensure you have the required prerequisite packages:
sudo apt install curl sqlite3
Warning: Ignoring the below prerequisites will result in a failed installation and non-functional application.
Installation Prerequisites
The below instructions are based on the following prerequisites. Change the instructions as needed to suit your specific needs if necessary.
* The userradarr
is created
* The userradarr
is part of the groupmedia
* Your download clients and media server run as and are a part of the groupmedia
* Your paths used by your download clients and media server are accessible (read/write) to the groupmedia
* You created the directory/var/lib/radarr
and ensured the userradarr
has read/write permissions for it for it
By continuing below, you acknowledge that you have read and met the above requirements.
- Download the correct binaries for your architecture.
- You can determine your architecture with
dpkg --print-architecture
- AMD64 use
arch=x64
- ARM, armf, and armh use
arch=arm
- ARM64 use
arch=arm64
- AMD64 use
- You can determine your architecture with
wget --content-disposition 'http://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64'
- Uncompress the files:
tar -xvzf Radarr*.linux*.tar.gz
- Move the files to
/opt/
sudo mv Radarr /opt/
Note: This assumes you will run as the user
radarr
and groupmedia
. You may change this to fit your usecase. 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 Radarr.
- Ensure ownership of the binary directory.
sudo chown radarr:radarr -R /opt/Radarr
- Configure systemd so Radarr can autostart at boot.
The below systemd creation script will use a data directory of
/var/lib/radarr
. Ensure it exists or modify it as needed. For the default data directory of/home/$USER/.config/Radarr
simply remove the-data
argument. Note: that$USER
is the User Radarr runs as and is defined below.
cat << EOF | sudo tee /etc/systemd/system/radarr.service > /dev/null
[Unit]
Description=Radarr Daemon
After=syslog.target network.target
[Service]
User=radarr
Group=media
Type=simple
ExecStart=/opt/Radarr/Radarr -nobrowser -data=/var/lib/radarr/
TimeoutStopSec=20
KillMode=process
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF
- Reload systemd:
sudo systemctl -q daemon-reload
- Enable the Radarr service:
sudo systemctl enable --now -q radarr
- (Optional) Remove the tarball:
rm Radarr*.linux*.tar.gz
Typically to access the Radarr web GUI browse to http://{Your server IP Address}:7878
Radarr uses a bundled version of ffprobe for media file analysis and does not require ffprobe or ffmpeg to be installed on the system. If Radarr says Ffprobe is not found this can typically be fixed with a reinstall.
If Radarr did not appear to start, then check the status of the service:
sudo journalctl --since today -u radarr
Uninstall
To uninstall and purge:
Warning: This will destroy your application data.
sudo systemctl stop radarr
sudo rm -rf /opt/Radarr
sudo rm -rf /var/lib/radarr
sudo rm -rf /etc/systemd/system/radarr.service
sudo systemctl -q daemon-reload
To uninstall and keep your application data:
sudo systemctl stop radarr
sudo rm -rf /opt/Radarr
sudo rm -rf /etc/systemd/system/radarr.service
sudo systemctl -q daemon-reload
FreeBSD
The Radarr team only provides builds for FreeBSD. Plugins and Ports are maintained and created by the FreeBSD community.
Instructions for FreeBSD installations are also maintained by the FreeBSD community and anyone with a GitHub account may update the wiki as needed.
Jail Setup Using TrueNAS GUI
- From the main screen select Jails
- Click ADD
- Click Advanced Jail Creation
- Name (any name will work): Radarr
- Jail Type: Default (Clone Jail)
- Release: 12.2-Release (or newer)
- Configure Basic Properties to your liking
- Configure Jail Properties to your liking but add
- allow_mlock
- allow_raw_sockets
allow_raw_sockets
is helpful for troubleshooting (e.g. ping, traceroute) but is not a requirement.
- Configure Network Properties to your liking
- Configure Custom Properties to your liking
- Click Save
- After the jail is created it will start automatically. One more property is required to be set in order for Radarr to see the storage space of your mounted media locations. Open a root shell on the server and enter these commands:
iocage stop <jailname>
iocage set enforce_statfs=1 <jailname>
iocage start <jailname>
Radarr Installation
Back on the jails list find your newly created jail for radarr
and click Shell
To install Radarr
* Ensure your pkg repo is configured to get packages from
/latest
and not/quarterly
* Check/usr/local/etc/pkg/repos/FreeBSD.conf
* If that does not exist, copy over/etc/pkg/FreeBSD.conf
to that location, open it, and replacequarterly
withlatest
pkg install radarr
Don’t close the shell out yet we still have a few more things!
Configuring Radarr
Now that we have it installed a few more steps are required.
Service Setup
Time to enable the service but before we do, a note:
The updater is disabled by default. The pkg-message
gives instructions on how to enable the updater but keep in mind: this can break things like pkg check -s
and pkg remove
for Radarr when the built-in updater replaces files.
To enable the service:
sysrc radarr_enable=TRUE
If you do not want to use user/group radarr
you will need to tell the service file what user/group it should be running under
sysrc radarr_user="USER_YOU_WANT"
sysrc radarr_group="GROUP_YOU_WANT"
radarr
stores its data, config, logs, and PID files in /usr/local/radarr
by default. The service file will create this and take ownership of it IF AND ONLY IF IT DOES NOT EXIST. If you want to store these files in a different place (e.g., a dataset mounted into the jail for easier snapshots) then you will need to change it using sysrc
sysrc radarr_data_dir="DIR_YOU_WANT"
Reminder: If you are using an existing location then you will manually need to either: change the ownership to the UID/GID radarr
uses AND/OR add radarr
to a GID that has write access.
Almost done, let’s start the service:
service radarr start
If everything went according to plan then radarr should be up and running on the IP of the jail (port 7878)!
You can now safely close the shell
Troubleshooting
- The service appears to be running but the UI is not loading or the page is timing out
- Double check that
allow_mlock
is enabled in the jail
- Double check that
System.NET.Sockets.SocketException (43): Protocol not supported
- Make sure you have
VNET
turned on for your jail, ip6=inherit, or ip6=new
- Make sure you have
The service script should now work around the lack of VNET and/or IP6 thus removing the requirement for VNET or ip6=inherit
Docker
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.
Avoid Common Pitfalls
Volumes and Paths
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 /movies
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 Radarr container, like /torrents.
The best solution is to use a single, common volume inside the containers, such as /data. Your Movies would be in /data/Movies
, 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 Radarr web UI (Settings › Download Clients).
Ownership and Permissions
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.
Published by