Radarr Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki
Radarr is a movie collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new movies and will automatically grab, sort, and rename them.
Before setting up Radarr, consider deploying the following containers first to simplify integration and avoid jumping between configuration steps:
- Sabnzbd (for Usenet downloading)
- Profilarr (For Sonarr / Radarr to customize media profiles)
- Prowlarr (for indexer / torrent searching)
- Transmission-openvpn (for Torrent downloading)
- Bazarr (if handling subtitles)
These services work closely with Sonarr, and having them set up beforehand streamlines the process.
💡 Highly Recommended: Use a VPN
When downloading torrents, your IP address is exposed to the public, making you vulnerable to tracking, data collection, and potential legal issues. Using a VPN ensures your internet traffic is encrypted and anonymized, protecting your identity and preventing unwanted scrutiny. Setting up Transmission-OpenVPN provides an extra layer of security, keeping your torrenting activities private and secure.
- Docker installed
- Radarr container running in your Docker stack
When rebuilding your NAS, ensure permissions for media directories are reset to match the account specified in your PUID
and PGID
environment variables. This ensures proper access for all services.
Use the following commands (replace /path/to/your/media
with your media directory path):
sudo chown -R <PUID>:<PGID> /path/to/your/Media
sudo chmod -R 770 /path/to/your/Media
sudo chown -R <PUID>:<PGID> /path/to/your/Downloads
sudo chmod -R 770 /path/to/your/Downloads
- Open your browser and navigate to
http://<your-ip-address>:7878
. - Upon first logon you will be asked to setup Authentication
**
⚠️ Hint: You can disable Authentication, I would only recommend if you are using some other authentication method. edit config.xml and replace<AuthenticationMethod>Basic</AuthenticationMethod>
with<AuthenticationMethod>External</AuthenticationMethod>
- Set Authentication Method
Basic
- Username
<Choose a username>
- Password
<Choose a password>
- Save
- Select
Settings
- Go to the
Media Management
section. - Click
Add Root Folder
and select the directory where your movie files are stored. - Enable
Rename Movies
- Select
Replace Illegal Characters
and chooseDelete
(e.g. File name goes from Mission: Impossible - Ghost Protocol to Mission Impossible - Ghost Protocol) - Enable
Import Extra Files
- Save
- Select
Library Import
from the left menu - Click on highlighted text under
Path
- Choose
Import x Movies
- It will take a few minutes to import. If a movies fails to match you will be returned to the import screen. Match the movie manually.
**
⚠️ Hint: If you have Profilarr setup these should all be pre-populated
- Go to the
Profiles
tab and ensure profiles were imported like1080p Balanced
, you can leave them set to defaults as you have created these from Profilarr - Move to the
Quality
tab and you can leave all these to defaults. I used to set Max to 75% to force smaller file sizes but have since moved to using Profilarr with quality profiles which seems to be doing a good balance of file size vs quality.- Optional, I do still set the Preferred to around 50%
-
Custom Formats
should have a lot of configurations from Profilarr
Profiles
Quality
Custom Formats
**
⚠️ Hint: If you followed the recommended Pre-Setup steps, the Indexers for Torrents will already be populated. You can add Usenet indexers here if desired.
-
Go to the
Settings
tab. -
Navigate to the
Indexers
section. There are two types: Torrents and Usenet. -
Click Add Indexer and select your preferred indexers.
-
Enter the necessary API keys or login credentials for each type of indexer.
Torrent:
- Name: Enter any friendly name—it doesn’t affect functionality.
- Enable RSS: Checked – This allows the indexer to fetch new releases automatically.
- Enable Automatic Search: Checked – Ensures the indexer can automatically search for missing content.
- Enable Interactive Search: Checked – Allows manual searches through the interface when needed.
- URL: – Use the public URL of the indexer.
-
API Key:
<KEY>
– If an API is required enter the API Key provided by the indexer. This is essential for authentication. -
Categories:
Movies
– Specify the categories to filter the content you want (e.g., SD, HD).
Usenet:
- Name: Enter any friendly name—this won’t impact functionality.
- Enable RSS: Checked – Allows the indexer to fetch new releases automatically without requiring manual searches.
- Enable Automatic Search: Checked – Ensures missing content is searched for and added automatically.
- Enable Interactive Search: Checked – Provides a manual search option within the interface when needed.
-
URL:
<Usenet URL>
– Use the public URL provided by your chosen Usenet indexer. -
API Key:
<KEY>
– Some Usenet indexers require an API Key for authentication—enter it here if applicable. -
Categories:
Movies
– Define which categories the indexer should retrieve, such as Standard Definition (SD) or High Definition (HD).
Optional Settings for Anime Content
If you’re including anime-specific content in your searches:-
Anime Categories:
Anime
– Filters results specifically for anime-related content. - Anime Standard Format Search: Checked – Ensures compatibility with common anime naming conventions, improving search accuracy.
💡 Tip: Unlike torrents, Usenet downloads are encrypted, meaning they’re inherently safer. However, using SSL connections and ensuring your provider doesn’t log searches enhances privacy and security.
- Select
Test
and if it is successfulSave
repeat as many times as needed. It is a good idea to add multiple torrent sites.
Torrent:
Usenet:
Setting up a download client allows Prowlarr, or Sabnzbd to automatically send requests to the appropriate service for handling downloads.
-
Navigate to the
Settings
tab. -
Go to the
Download Clients
section. -
Click
+
and select your preferred download client (e.g., SABnzbd, Transmission, qBittorrent, NZBGet). -
Enter the necessary connection details:
- Name: Enter a friendly name—this can be anything, but it helps with organization.
- Enable: ✅ Checked – Ensures the client is active and receiving requests.
-
Host:
<Host Name>
– The address of the client (e.g.,localhost
,transmission-openvpn.example
,<Host IP>
<Container IP>
). -
Port:
<Port Number>
– Default values depend on the client:- Transmission:
9091
- qBittorrent:
8080
- Deluge:
8112
- Custom: (Check your client’s settings)
- Transmission:
-
Username:
<Username>
– If authentication is required, enter your credentials. -
Password:
<Password>
– Use the password for your download client if applicable. -
Categories:
TV
,Movies
,Music
– Define categories to filter content and ensure proper sorting.
- Name: Enter a friendly name for organizational purposes.
- Enable: ✅ Checked – Ensures the client is actively processing Usenet downloads.
-
Host:
<Host Name>
– The address of your Usenet client (e.g.,localhost
,sabnzbd.example
,<Host IP>
). -
Port:
<Port Number>
– Default ports:- SABnzbd:
8080
- NZBGet:
6789
- Custom: (Check your client’s settings)
- SABnzbd:
-
API Key:
<KEY>
– Copy the API Key from your Usenet client's settings (Settings > General > API Key
). -
Categories:
Movies
,TV Shows
,Music
– Define categories for better organization.
-
Click
Save
.
Torrents:
Usenet:
- Users to automatically add movies from external sources like IMDb, Trakt, or TMDb to their Radarr library, ensuring their collection stays updated with desired films
- Navigate to the
Import Lists
tab. - Click
Add +
. - Find
Plex List
and choosePlex Watchlist
- Check
Enable
, Quality Profile to1080p Balanced
,Start Oauth
, thanTest
, and if everyting worksSave
- I also like to add some other lists for auto adding moves (e.g. SteveLu, and Trakit Lists: Top Week Watched Trakt List BoxOffice
- StevenLu: leave defaults
- Top Week Watched:
Enabled
Username:
linaspurinis
List Name:top-watched-movies-of-the-week
- BoxOffice:
Enabled
List Type:
Top Box Office Movies
Rating:60-100
- Navigate to the
Connect
tab. - Click
+
. - Search for
Plex Media Server
and select it - Disable,
On Movie Delete, On Movies File Delete, On Movie File Delete for Upgrade
- Fill in the
Host
field with your container name (e.g. Plex.example) - Click
Save
. - Optional, you can also add a discord server to track usuage
- Navigate to the
Movies
tab. - Click
Add New
, there is also theDiscover
which is handy. - Search for and select the movies you want Radarr to monitor.
- Configure the monitoring options (e.g., quality, folders).
- Click
Save
.
- Ensure all paths and environment variables are updated in the
.env
file. - Regularly backup your
config
directory to save your settings.
- Common Issues: List common issues and solutions.
- Logs: Check Radarr logs for error messages.
- Support: Link to the Radarr community and support resources.