Wiki > Sonarr
"Sonarr is a PVR for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new episodes of your favorite shows and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available."
Installation
Sonarr is available as an app on your Manage page. Select Manage Apps next to the slot you want to use Sonarr on. On this page, select Add Sonarr
and provide your Whatbox password. After a short wait, you can click Open Sonarr
to open Sonarr. You can also access Sonarr from your Manage page.
Updates
Sonarr updates are currently managed by us. Attempting to use the built-in automatic update or restart functions in Sonarr will fail. If you have attempted to update Sonarr and Sonarr is no longer accessible, connect to your slot via SSH, run pkill -f Sonarr.exe; rm ~/.config/Sonarr/sonarr.pid
and then restart Sonarr from your Manage page.
Connecting to clients
Connecting to rTorrent
Under Settings > Download Client, select to add a client with the + button and then select rTorrent. Enter rTorrent or a label of your choice for the Name, and your Whatbox site password for the Password. All of the other options can be left the same.
Connecting to Transmission
Under Settings > Download Client, select to add a client with the + button and then select Transmission. Enter Transmission or a label of your choice for the Name, and your Whatbox site password for the Password. All of the other options can be left the same.
Connecting to qBittorrent
Under Settings > Download Client, select to add a client with the + button and then select qBittorrent. Enter qBittorrent or a label of your choice for the Name, and your Whatbox site password for the Password. All of the other options can be left the same.
Connecting to Deluge
Make sure the Deluge WebUI has been enabled from the Settings link on your Manage page.
Under Settings > Download Client, select to add a client with the + button and then select Deluge. Enter Deluge or a label of your choice for the Name, and your Whatbox site password for the Password. All of the other options can be left the same.
Common troubleshooting
If one of your Download Clients is unable to be added, there can be a couple of reasons for this:
- The app itself is not running. Ensure that this is the case by checking your Manage page.
- The password was entered incorrectly. This can happen when the password is pasted. Try typing it manually.
Automatically Restart
mono-based applications are inherently unstable and prone to crashing. Below are steps to take to have your Sonarr instance automatically restart if it crashes, or if the server is rebooted.
- Make a file to be used for the script.
touch ~/sonarr_restart.cron
- Edit the file and enter the text below.
nano -w ~/sonarr_restart.cron
#!/bin/bash
if pgrep -fx "/usr/bin/sonarr" > /dev/null
then
echo "Sonarr is running."
else
echo "Sonarr is not running, starting Sonarr"
/usr/bin/sonarr
fi
exit
- Save the file with Ctrl+x and the "y" and Enter to accept overwriting.
- Make the script executable.
chmod +x ~/sonarr_restart.cron
- Open your crontab.
EDITOR=nano crontab -e
- Enter the following text
@reboot /home/user/sonarr_restart.cron >/dev/null 2>&1
*/5 * * * * /home/user/sonarr_restart.cron >/dev/null 2>&1
- Save the crontab with Ctrl+x and the "y" and Enter to accept overwriting.
To automatically restart a second radarr process that uses a different configuration (see below), create a new script file using the same contents but replace "/usr/bin/sonarr"
with "/usr/bin/sonarr -data=/home/user/.config/Sonarr2"
in both instances.
Advanced: Manually run another configuration
These instructions will create and run another configuration of Sonarr alongside your existing configuration. You will need to manually access and manage additional configurations of Sonarr, including starting them if your server is ever rebooted.
- Make a second Sonarr configuration directory
mkdir ~/.config/Sonarr2
- Make a second Sonarr configuration file
touch ~/.config/Sonarr2/config.xml
- Open the configuration file in nano
nano ~/.config/Sonarr2/config.xml
- Copy the contents of the box below into the ~/.config/Sonarr2/config.xml file, replacing any other configuration in the file
<Config>
<Port>26562</Port>
<UrlBase></UrlBase>
<BindAddress>*</BindAddress>
<SslPort>29281</SslPort>
<EnableSsl>False</EnableSsl>
<ApiKey></ApiKey>
<AuthenticationMethod>None</AuthenticationMethod>
<LogLevel>Info</LogLevel>
<Branch>develop</Branch>
<LaunchBrowser>False</LaunchBrowser>
<UpdateAutomatically>False</UpdateAutomatically>
</Config>
-
Save changes by pressing
ctrl+x
,y
and thenenter
. -
Start Sonarr in a screen session running in the background
screen -dmS sonarr2 /usr/bin/sonarr -data=/home/user/.config/Sonarr2
Sonarr will be accessible at http://server.whatbox.ca:26562 - Important: You must enable Authentication in Sonarr's Settings -> General tab, using the Forms authentication method with a username (user) and strong password.