¶ What is Radarr?
Radarr is a movie collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new movies and will interface with clients and indexers to grab, sort, and rename them. It can also be configured to automatically upgrade the quality of existing files in the library when a better quality format becomes available.
¶ Installation Methods
Radarr can be installed using Docker Compose or directly via the TrueNAS SCALE Community Apps Catalog.
services:
radarr:
image: lscr.io/linuxserver/radarr:latest
container_name: radarr
environment:
- PUID=568
- PGID=568
- TZ=America/New_York
volumes:
- /mnt/tank/configs/radarr:/config
- /mnt/tank/media:/media
ports:
- 7878:7878
restart: unless-stopped
¶ Permissions & Folder Structure
- PUID / PGID: Ensure you use a user/group with the correct permissions for accessing media folders. TrueNAS SCALE defaults to 568:568 for apps.
- Volumes: The container structure follows a common-sense naming convention, storing configurations under /mnt/tank/configs/radarr
- 📌 Refer to the Folder-Structure guide for more details.
- Install Radarr from the TrueNAS Community Apps catalog.
- Use the Community version when available.
- Change the Config Storage Type to Host Path as per the TrueNAS SCALE guide.
- Click Add under Additional Storage to mount the media directory inside the container.
¶ Radarr Specific Changes
¶ Root Folder
- Navigate in Radarr to Settings > Media Management
- click the button to Add Root Folder.
- Select the folder path to
/media/movies.
¶ Download Client
- Navigate in Radarr to Settings > Download Client
- Click the ➕ icon. Click the box for qBittorrent.
- Configure the following:
| Setting | Value |
|---|---|
| Host | Server IP |
| Port | qBittorrent WebUI port |
| Use Credentials | Set up during qBittorrent installation |
- Click Test, then Save.
¶ Advanced Settings
The below settings are for advanced users and are totally optional. To see all of the Advanced fields (usually colored orange) be sure to click the cog icon in the top left of the window to Show Advanced.
This also assumes you are using Recyclarr to sync data to Radarr. If you are not, do not continue. See the video walkthrough below for more details.
¶ Media Management
| Field | Value |
|---|---|
| Rename Movies | True |
| Standard Movie Format | {Movie CleanTitle} {(Release Year)} [imdbid-{ImdbId}] - {Edition Tags }{[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]} |
| Propers and Repacks | Do Not Prefer |
| Recycling Bin Cleanup | 1 |
| Set Permissions | True |
| chmod Folder | 777 |
¶ Profiles
- Delete all profiles not created by Recyclarr.
- Change the default profile for Jellyseerr to the new ones created by Recyclarr.
- If you cannot delete a profile it is because it is in use by a movie. Reassign the profile before deleting the old one.
Why use Recyclarr profiles?
Recyclarr automates profile creation and ensures consistent quality filtering, metadata tagging, and download prioritization for a better Radarr experience.
¶ Connect
See this section of the Notifications page.
¶ Metadata
Select Kodi (XBMC)/Emby and check the Enable box. Save and close.
Why enable metadata?
Enabling metadata allows Radarr to send detailed episode information, artwork, and tags to your media server (Kodi/Emby), enhancing library organization.
¶ General > Backups
- Scroll all the way to the bottom to the Backups section
- Change the folder to
/media - Set the Interval to 1
- Set the Retention to your preference. (default: 7 days)
¶ Troubleshooting
¶ Radarr Cannot See Media Files
- Ensure your volume paths in Docker match the root folder in Radarr.
- Run to check file ownership and permissions:
ls -lah /mnt/tank/media/movies
- If needed, change ownership using:
chown -R 568:568 /mnt/tank/media/movies
¶ Permission Errors (Permission Denied)
- Ensure your user (PUID / PGID) has access to the media folders.
- Try running:
chmod -R 770 /mnt/tank/media/movies
¶ Radarr is Downloading But Not Moving Files
- Verify that your Download Client Path Mapping is correctly set.
- In Settings > Download Clients, ensure Radarr has access to the completed download folder.
