¶ Table of Contents
- Table of Contents
- Radarr Basics
- How does Radarr work?
- How does Radarr find movies?
- How do I access Radarr from another computer?
- What is Minimum Availability?
- How are possible downloads compared?
- What are Lists and what can they do for me?
- Why are lists sync times so long and can I change it?
- Can all my movie files be stored in one folder?
- Can I put all my movies in my library into one folder?
- How do I update Radarr?
- Can I switch from
nightlyback todevelop? - Can I switch between branches?
- How do I Backup/Restore Radarr?
- Radarr Common Problems
- Error of a task was canceled
- Path is Already Configured for an Existing Movie
- How can I rename my movie folders?
- Movie File and Folder Naming
- Movie Folders Named Incorrectly
- Can I disable the refresh movies task
- How do I request a feature for Radarr?
- Help, My Mac says Radarr cannot be opened because the developer cannot be verified
- Help, My Mac says Radarr.app is damaged and can’t be opened
- I am getting an error: Database disk image is malformed
- I use Radarr on a Mac and it suddenly stopped working. What happened?
- Why can Radarr not see my files on a remote server?
- How do I change from the Windows Service to a Tray App?
- Help I have locked myself out
- How do I stop the browser from launching on startup?
- Weird UI Issues
- Web Interface Only Loads at localhost on Windows
- Permissions
- System & Logs loads forever
- Finding Cookies
- Unpack Torrents
- uTorrent is no longer working
- I got a pop-up that said config.xml was corrupt, what now?
- Invalid Certificate and other HTTPS or SSL issues
- VPNs, Jackett, and the *ARRs
- Radarr Searching and Downloading Common Problems
- Why can I not add a new movie to Radarr?
- How does Radarr determine the year of a movie?
- Jackett shows more results than when manually searching
- How does Radarr handle foreign movies or foreign titles?
- How does Radarr handle "multi" in names?
- Help, Movie Added, But Not Searched
- Jackett's /all Endpoint
- Why are there two files? | Why is there a file left in downloads?
- Why doesn't Radarr work behind a reverse proxy
¶ Radarr Basics
¶ How does Radarr work?
- Radarr does not regularly search for movie files that are missing or have not met their quality goals. Instead, it fairly frequently queries your indexers and trackers for all the newly posted movies, then compares that with its list of movies that are missing or need to be upgraded. Any matches are downloaded. This lets Radarr cover a library of any size with just 24-100 queries per day (RSS interval of 15-60 minutes). If you understand this, you will realize that it only covers the future though.
- So how do you deal with the present and past? When you're adding a movie, you will need to set the correct path, profile and monitoring status then use the Start search for missing movie checkbox. If the movie hasn't been released yet, you do not need to initiate a search.
- Put another way, Radarr will only find movies that are newly uploaded to your indexers. It will not actively try to find movies you want that were uploaded in the past.
- If you've already added the movie, but now you want to search for it, you have a few choices. You can go to the movie's page and use the search button, which will do a search and then automatically pick one. You can use the Search tab and see all the results, hand picking the one you want. Or you can use the filters of
Missing,Wanted, orCut-off Unmet. - If Radarr has been offline for an extended period of time, Radarr will attempt to page back to find the last release it processed in an attempt to avoid missing a release. As long as your indexer supports paging and it hasn't been too long Radarr will be able to process the releases it would have missed and avoid you needing to perform a search for the missed movies.
¶ How does Radarr find movies?
This FAQ item is a legacy FAQ Entry. Refer to How does Radarr work?
¶ How do I access Radarr from another computer?
- By default Radarr doesn't listen to requests from all systems (when not run as administrator), it will only listen on localhost, this is due to how the Web Server Radarr uses integrates with Windows (this also applies for current alternatives). If Radarr is run as an administrator it will correctly register itself with Windows as well as open the Firewall port so it can be accessed from other systems on your network. Running as admin only needs to happen once (if you change the port it will need to be re-run).
¶ What is Minimum Availability?
- Announced: Radarr shall consider movies available as soon as they are added to Radarr. This setting is recommended if you have good private trackers (or really good public ones, e.g. rarbg.to) that do not have fakes.
- In Cinemas: Radarr shall consider movies available as soon as movies hit cinemas (Theatrical date on TMDb) This option is not recommended.
- Released: Radarr shall consider movies available as soon as the Blu-Ray or streaming version is released (Digital and Physical dates on TMDb) This option is recommended and likely should be combined with an Availability Delay of
-14or-21days.
¶ How are possible downloads compared?
Generally Quality Trumps All. If you wish to have Quality not be the main priority - you can merge your qualities together. See TRaSH's Guide
-
The current logic can always be found here.
-
As of 2022-01-23 the logic is as follows:
- Quality*
- Custom Format Score
- Protocol (as configured in the relevant Delay Profile)
- Indexer Priority
- Indexer Flags
- Seeds/Peers (If Torrent)
- Age (If Usenet)
- Size
This ranking applies to both releases that would be Quality and/or Custom Format upgrades.
*REPACKS and PROPERs are v2 of Qualities and thus rank above a non-repack of the same quality. Set Media Management => File Management
Download Proper & Repacks"Do Not Prefer" and use the Repack/Proper Custom Format.
¶ What are Lists and what can they do for me?
- Lists are a part of Radarr that allow you to follow a given list creator.
- Let's say that you follow a given list creator on Trakt/TMDb and really like their Marvel Cinematic Universe film section and want to watch every movie on their list. You look in your Radarr and realize that you do not have those movies. Well instead of searching one by one and adding those lists and then searching your indexers for those movies. You can do this all at once with a List. The Lists can be set to import all the movies on that curators list as well as be set to automatically assign a quality profile, automatically add, and automatically monitor that movie.
CAUTION: If done improperly lists can wreak havoc on your library by adding many movies you have no intention of watching. Make certain you are familiar with the list before you click save.
- It's suggested that physically look at the list before you even go to Radarr.
¶ Why are lists sync times so long and can I change it?
- Lists never were nor are intended to be
add it nowthey arehey i want this, add it eventuallytools - You can trigger a list refresh manually, add the movies to Radarr, use Ombi, Petio, Overseer, or any similar app that adds them right away
- This restriction is to not have our server and list providers get killed by people updating lists every 10 minutes.
- This interval can be configured in Settings => Lists for between 6-24 hours. The default is 24 hours.
¶ Can all my movie files be stored in one folder?
- No and the reason is that Radarr is a fork of Sonarr, where every show has a folder. This limitation is a known pain point for many users and will maybe come in a future version. Please note that it is not a simple change and effectively requires an entire rewrite of the backend.
- The Custom Folder GitHub Issue technically covers this request, but it is no guarantee that all movie files in one folder will be implemented at that time.
- A slight hack-ish solution is described below. Please note that you mustn't trigger a rescan in Radarr or it will show as missing and regardless the movie will never be upgraded.
- Use a Custom Script
- the script should be triggered on import
- it should be designed to move the file whenever you want it
- it then needs to call the Radarr API and change the movie to unmonitored.
- Use a Custom Script
- If you're looking to moving all your movies from one folder to individual folders check out the Tips and Tricks Section => Create a Folder for Each Movie article
¶ Can I put all my movies in my library into one folder?
- No, see above.
¶ How do I update Radarr?
- Go to Settings and then the General tab and show advanced settings (use the toggle by the save button).
- Under the Updates section change the branch name to
masterordevelop - Save
This will not install the bits from that branch immediately, it will happen during the next update.
-
- (Default/Stable): It has been tested by users on the develop and nightly branches and it’s not known to have any major issues. This version will receive updates approximately monthly. On GitHub, this is the
masterbranch. -
- (Beta): This is the testing edge. Released after tested in nightly to ensure no immediate issues. New features and bug fixes released here first after nightly. It can be considered semi-stable, but is still
beta. This version will receive updates either weekly or biweekly depending on development.
Warning: You may not be able to go back to
masterafter switching to this branch. On GitHub, this is a snapshot of thedevelopbranch at a specific point in time.
- (Alpha/Unstable) : This is the bleeding edge. It is released as soon as code is committed and passes all automated tests. This build may have not been used by us or other users yet. There is no guarantee that it will even run in some cases. This branch is only recommended for advanced users. Issues and self investigation are expected in this branch. Use this branch only if you know what you are doing and are willing to get your hands dirty to recover a failed update. This version is updated immediately.
Warning: You may not be able to go back to
masterafter switching to this branch. On GitHub, this is thedevelopbranch.
- Note: If your install is through Docker append
:release,:latest,:testing, or:developto the end of your container tag depending on who makes your builds.
|
|
|
|
|---|---|---|---|
| hotio | release |
testing |
nightly |
| LinuxServer.io | latest |
develop |
nightly |
¶ Can I update Radarr inside my Docker container?
- Technically, yes. But you absolutely should not. It is a primary philosophy of Docker. Database issues can arise if you upgrade your installation inside to the most recent
nightly, but then update the Docker container itself (possibly downgrading to an older version).
¶ Installing a newer version
¶ Native
- Go to System and then the Updates tab
- Newer versions that are not yet installed will have an update button next to them, clicking that button will install the update.
¶ Docker
- Repull your tag and update your container
¶ Can I switch from nightly back to develop?
¶ Can I switch between branches?
- If version is identical you are able to switch, otherwise check with the development team to see if you can switch from
nightlytomaster;nightlytodevelop; ordeveloptomasterfor your given build. - Failure to follow these instructions may result in your Radarr becoming unusable or throwing errors. You have been warned. If the below errors are encountered then you are using a newer database with an older *Arr version which is not supported. Upgrade *Arr to the version you were previously on or newer.
- Example Error Messages:
Error parsing column 45 (Language=31 - Int64)The DataMapper was unable to load the following field: 'Languages' valueID does not match a known language Parameter name: id- Other similar database errors around missing columns or tables.
- Example Error Messages:
¶ How do I Backup/Restore Radarr?
¶ Backing up Radarr
¶ Using built-in backup
- Go to System => Backup in the Radarr UI
- Click the Backup button
- Download the zip after the backup is created for safekeeping
¶ Using file system directly
- Find the location of the AppData directory for Radarr
- Via the Radarr UI go to System => About
- Radarr Appdata Directory
- Stop Radarr - This will prevent the database from being corrupted
- Copy the contents to a safe location
¶ Restoring from Backup
Restoring to an OS that uses different paths will not work (Windows to Linux, Linux to Windows, Windows to OS X or OS X to Windows), moving between OS X and Linux may work, since both use paths containing
/instead of\that Windows uses, but is not supported. You'll need to manually edit all paths in the database.
¶ Using zip backup
- Re-install Radarr (if applicable / not already installed)
- Run Radarr
- Navigate to System => Backup
- Select Restore Backup
- Select Choose File
- Select your backup zip file
- Select Restore
¶ Using file system backup
- Re-install Radarr (if applicable / not already installed)
- Find the location of the AppData directory for Radarr
- Running Radarr once and via the UI go to System => About
- Radarr Appdata Directory
- Stop Radarr
- Delete the contents of the AppData directory (Including the .db-wal/.db-journal files if they exist)
- Restore from your backup
- Start Radarr
- As long as the paths are the same, everything will pick up where it left off
¶ File System Restore on Synology NAS
CAUTION: Restoring on a Synology requires knowledge of Linux and Root SSH access to the Synology Device.
- Re-install Radarr (if applicable / not already installed)
- Find the location of the AppData directory for Radarr
- Running Radarr once and via the UI go to System => About
- Radarr Appdata Directory
- Stop Radarr
- Connect to the Synology NAS through SSH and log in as root
On some installations, the user is different than the below commands:
chown -R sc-Radarr:Radarr *
-
Execute the following commands:
rm -r /usr/local/Radarr/var/.config/Radarr/Radarr.db cp -f /tmp/Radarr_backup/* /usr/local/Radarr/var/.config/Radarr/ -
Update permissions on the files:
cd /usr/local/Radarr/var/.config/Radarr/ chown -R Radarr:users * chmod -R 0644 * -
Start Radarr
¶ Radarr Common Problems
¶ A Task was Canceled
- Radarr received no response from the server the request was made to after 100 seconds.
- Logs will contain
System.Threading.Tasks.TaskCanceledException: A task was canceled. - This is often caused by:
- improperly configured or use of a VPN
- improperly configured or use of a proxy
- local DNS issues
- local IPv6 issues - most common - typically IPv6 is enabled on the host system, but non-functional
- the use of Privoxy and it being improperly configured
- PiHole Rate Limiting requests
- You can troubleshoot with DNS
nslookup <domain.tld from trace logs>and ipv6 withcurl -sv -6 "<url from trace logs>"/ all other connectivity withcurl -sv -4 "<url from trace logs>"
¶ Path is Already Configured for an Existing Movie
- Library Import shows "Existing" or you get an error of "Path is configured for an existing movie"
- This occurs when trying to add a movie or edit an existing movie's path that already is assigned to a different movie.
- Likely this was caused by not correcting a mismatched movie when the user imported their library.
- Locate and correct the movie that is already assigned to that movie's path.
- Movie Index
- Table View
- Options => Add path as a column
- Sort and find the movie at the noted problematic path.
- Alternatively, delete the movie using the existing path from Radarr
¶ How can I rename my movie folders?
The same process applies for moving/changing Movie paths as well. If you're just updating paths in Radarr and do not need to move the files, then do not select "Yes Move files" in Step 5.
- Movies
- Movie Editor
- Select what movies need their folder renamed
- Change Root Folder to the same Root Folder that the movies currently exist in
- Select "Yes move files"
If you are using Plex, this will trigger re-detection of intros, thumbnails, chapters, and preview metadata.
¶ Movie File and Folder Naming
-
Currently, Radarr requires that each movie be in a folder with the format containing at minimum
Movie Title (Year)/, optionally_or.are valid separators. To facilitate correct quality and resolution identification during import, a file name likeMovie Title (Year) [Quality-Resolution].extis best, again_or.are valid separators too.- A useful tool for making these changes to your collection is filebot which has paid version in both the Apple and Windows stores, but can be found for free on their legacy SourceForge site. It has both a GUI and CLI, so you can use whatever you’re comfortable with. For the above example,
{ny}expands toName (Year)and{vf}gives the resolution like1080p. There is nothing to infer quality, so you can fake it using{ny}/{ny} [{dim[0] >= 1280 ? 'Bluray' : 'DVD'}-{vf}]which will name anything lower than 720p to[DVD-572p]and greater or equal to 720p like[Bluray-1080p].
- A useful tool for making these changes to your collection is filebot which has paid version in both the Apple and Windows stores, but can be found for free on their legacy SourceForge site. It has both a GUI and CLI, so you can use whatever you’re comfortable with. For the above example,
-
See Tips and Tricks Section => Create a Folder for Each Movieradarr/tips-and-tricks#creating-a-folder-for-each-movie) for more details.
¶ Movie Folders Named Incorrectly
-
Movie Folder naming is based on the metadata (name/year) at the time the movie was added. If you added a movie before it was released, you may need to use the rename folder trick noted above to update the movie folded naming to reflect the new current data.
-
Even if your movies are in folders already, the folders may not be named correctly. The folder name should be
Movie Title (Year), having the title and year in the folder’s name is critical right now.- Examples that will work well:
/mnt/Movies/A Clockwork Orange (1971)/A Clockwork Orange (1971) [Bluray-1080p].mkv/mnt/Kid Movies/Frozen (2013)/Frozen (2013) [Bluray-1080p].mkv
- Examples that will work, but will require manual management:
- By letters:
/mnt/Movies/A-D/A Clockwork Orange (1971)/A Clockwork Orange (1971) [Bluray-1080p].mkv - By rating:
/mnt/Movies/R/A Clockwork Orange (1971)/A Clockwork Orange (1971) [Bluray-1080p].mkv - By genre:
/mnt/Movies/Crime, Drama, Sci-Fi/A Clockwork Orange (1971)/A Clockwork Orange (1971) [Bluray-1080p].mkv - These examples will require manual management when the movie is added. Each of the examples will have many root directories, like
A-DandE-Gin the first letter example,RandPG-13in the rating example and you can guess at the variety of genre folders. When adding a new movie, the correct base folder will need to be selected for this format to work.
- By letters:
- Examples that won’t work:
- Single folder:
/mnt/Kid Movies/Frozen (2013) [Bluray-1080p].mkv- At this time, movies simply have to be in a folder named after the movie. There is no way around this until development work is done to add this feature.
- Movie Folder Naming Formats from v0.2 that include File properties in the movie folder name such as
{Movie.Title}.{Release Year}.{Quality.Full}-{MediaInfo.Simple}{`Release.Group}will not work in v3.- Folders are related to the movie and independent of the file. Additionally, this will break with the planned multiple files per movie support.
- The other reason it was removed was it caused frequent confusion, database corruption, and generally was only half baked.
- Single folder:
- The Tips and Tricks Section => Create a Folder for Each Movie is a great source for making sure your file and folder structure will work great.
- Examples that will work well:
¶ Can I disable the refresh movies task
- No, nor should you through any SQL hackery. The refresh movies task queries the upstream Servarr proxy and checks to see if the metadata for each movie (ids, cast, summary, rating, translations, alt titles, etc.) has updated compared to what is currently in Radarr. If necessary, it will then update the applicable movies.
- A common complaint is the Refresh task causes heavy I/O usage.
- The main setting is "Rescan Movie Folder after Refresh". If your disk I/O usage spikes during a Refresh then you may want to change the Rescan setting to
Manual.- Do not change this to
Neverunless all changes to your library (new movies, upgrades, deletions etc) are done through Radarr. - If you delete movie files manually or via Plex or another third party program, do not set this to
Never.
- Do not change this to
- The other setting that can be changed is "Analyze video files" which is advised to be enabled if you use tdarr or otherwise externally modify your files. If you do not you can safely disable "Analyze video files" to reduce some I/O.
¶ How do I request a feature for Radarr?
- This is an easy one click here
¶ Help, My Mac says Radarr cannot be opened because the developer cannot be verified
- This is simple, please see this link for more information here
- Alternatively, you may need to self-sign Radarr
codesign --force --deep -s - Radarr.app
¶ Help, My Mac says Radarr.app is damaged and can’t be opened
- That is either due to a corrupt download so try again or security issues, please see this related FAQ entry.
¶ I am getting an error: Database disk image is malformed
* For Radarr users experiencing this after upgrading to v4.X versions. v4 versions do several far reaching migrations because of that if your database had previous corruption at any place (which may not have been detectable previously running Radarr) the migration will bomb out and fail. This will cause Radarr to fail to start. It is likely all your backups are corrupt as well, so simply restoring those will likely not resolve the issue.
* If the post-migrated database will not open or cannot be recovered then make a copy of the database from a recent backup and apply the database recovery process to that file then try starting Radarr with the recovered backup file. It should then migrate without issues.
- Errors of
Error creating log databaseindicate issues with logs.db- This can quickly be resolved by renaming or removing the database. The logs database contains unimportant information regarding commands history and update install history, and Info, Warn, and Error entries
- Errors of
Error creating main databaseor genericdatabase disk image is malformedwith no specified database indicate issues with radarr.db- Continue with the steps noted below
- This means your SQLite database that stores most of the information for Radarr is corrupt. Your options are to try (a) backup(s), try recovering the existing database, try recovering the backup(s), or if all else fails starting over with a fresh new database.
- This error may show if the database file is not writable by the user/group *Arr is running as. Permissions being the cause will likely only be an issue for new installs, migrated installs to a new server, if you recently modified your appdata directory permissions, or if you changed the user and group *Arr run as.
- Your best and first option is to try restoring from a backup. However, for users receiving this after upgrading to v4 it is highly unlikely the backup itself will work and you'll need to try the other recovery methods mentioned.
- You can also try recovering your database. This is typically the only option for when this issue occurs after an update. Try the sqlite3
.recovercommand- If your sqlite does not have
.recoveror you wish a more GUI (i.e. Windows) friendly way then follow our instructions on this wiki.
- If your sqlite does not have
- Another possible cause of you getting an error with your Database is that you're placing your database on a network drive (nfs or smb or something else not local). SQLite is designed for situations where the data and application coexist on the same machine. Thus your *Arr AppData Folder (/config mount for docker) MUST be on local storage. SQLite and network drives not play nice together and will cause a malformed database eventually.
- If you are using mergerFS you need to remove
direct_ioas SQLite uses mmap which isn’t supported bydirect_ioas explained in the mergerFS docs here
¶ I use Radarr on a Mac and it suddenly stopped working. What happened?
- Most likely this is due to a MacOS bug which caused one of the databases to be corrupted.
- See the above database is malformed entry.
- Then attempt to launch and see if it works. If it does not work, you will need further support. Post in our subreddit /r/radarr or hop on our discord for help.
¶ Why can Radarr not see my files on a remote server?
- For all OSes ensure the user/group you're running *Arr as has read and write access to the mounted drive.
- For Linux ensure:
- If you're using an NFS mount ensure
nolockis enabled for your mount. - If you're using an SMB mount ensure
nobrlis enabled for your mount.
- If you're using an NFS mount ensure
- For Windows: In short: the user *Arr is running as (if service) or under (if tray app) cannot access the file path on the remote server. This can be for various reasons, but the most common is *Arr is running as a service, which causes the issues described below.
¶ Radarr runs under the LocalService account by default which doesn't have access to protected remote file shares
- Run Radarr's service as another user that has access to that share
- Open the Administrative Tools > Services window on your Windows server.
- Stop the Radarr service.
- Open the Properties > Log On dialog.
- Change the service user account to the target user account.
- Run Radarr.exe using the Startup Folder
¶ You're using a mapped network drive (not a UNC path)
- Change your paths to UNC paths (
\\server\share) - Run Radarr.exe via the Startup Folder
¶ How do I change from the Windows Service to a Tray App?
- Shut down Radarr
- Run serviceuninstall.exe that's in the Radarr directory
- Run
Radarr.exeas an administrator once to give it proper permissions and open the firewall. Once complete, then you can close it and run it normally. - (Optional) Drop a shortcut to .exe in the startup folder to auto-start on boot.
¶ Help I have locked myself out
To disable authentication (to reset your forgotten username or password) you will need need to edit config.xml which will be inside the Radarr Appdata Directory
- Open config.xml in a text editor
- Find the authentication method line will be
<AuthenticationMethod>Basic</AuthenticationMethod>or<AuthenticationMethod>Forms</AuthenticationMethod> - Change the
AuthenticationMethodline to<AuthenticationMethod>None</AuthenticationMethod> - Restart Radarr
- Radarr will now be accessible without a password, you should go the
Settings: Generalin the UI and set your username and password
¶ How do I stop the browser from launching on startup?
Depending on your OS, there are multiple possible ways.
- In
Settings=>Generalon some OS'es, there is a checkbox to launch the browser on startup. - When invoking Radarr, you can add
-nobrowser(*nix) or/nobrowser(Windows) to the arguments. - Stop Radarr and edit the config.xml file, and change
<LaunchBrowser>True</LaunchBrowser>to<LaunchBrowser>False</LaunchBrowser>.
¶ Weird UI Issues
- If you experience any weird UI issues like the Library page not listing anything or a certain view or sort not working, try viewing in a Chrome Incognito Window or Firefox Private Window. If it works fine there, clear your browser cache and cookies for your specific ip/domain. For more information, see the Clear Cache Cookies and Local Storage wiki article.
¶ Web Interface Only Loads at localhost on Windows
- If you can only reach your web interface at http://localhost:7878/ or http://127.0.0.1:7878/, you need to run as administrator at least once.
¶ Permissions
- Radarr will need to move files away from where the downloader puts them into the final location, so this means that will need to read/write to both the source and the destination directory and files.
- On Linux, where best practices have services running as their own user, this will probably mean using a shared group and setting folder permissions to
775and files to664both in your downloader and . In umask notation, that would be002.
¶ System & Logs loads forever
- It's the easy-privacy blocklist. They basically block any url with /api/log? in it. Look over the list and tell me if you think that blocking all the urls in that list is a sensible idea, there are dozens of urls in there that potentially break sites. You selected that in your adblocker. Easy solution is to whitelist the domain Radarr is running on. But I still recommend checking the list.
¶ Unpack Torrents
- Most torrent clients doesn’t come with the automatic handling of compressed archives like their usenet counterparts. We recommend unpackerr.
¶ uTorrent is no longer working
- Ensure the Web UI is enabled
- Ensure that the Alt Listening Port (Advanced => Web UI) is not the same as the Listening Port (Connections)
- We'd suggest changing the Web UI Alt Listening Port so as to not mess with any port forwarding for connections.
¶ I got a pop-up that said config.xml was corrupt, what now?
- Radarr was unable to read your config file on start-up as it became corrupted somehow. In order to get back online, you will need to delete
.xmlin your appdata-directory, once deleted start and it will start on the default port (7878), you should now re-configure any settings you configured on the General Settings page.
¶ Invalid Certificate and other HTTPS or SSL issues
- Your download client stopped working and you're getting an error like
Localhost is an invalid certificate?- Radarr validates SSL certificates. If there is no SSL certificate set in the download client, or you're using a self-signed https certificate without the CA certificate added to your local certificate store, then will refuse to connect. Free properly signed certificates are available from let's encrypt.
- If your download client and are on the same machine there is no reason to use HTTPS, so the easiest solution is to disable SSL for the connection. Most would agree it's not required on a local network either. It is possible to disable certificate validation in advanced settings if you want to keep an insecure SSL setup.
¶ VPNs, Jackett, and the *ARRs
- Unless you're in a repressive country like China, Australia or South Africa, your torrent client is typically the only thing that needs to be behind a VPN. Because the VPN endpoint is shared by many users, you can and will experience rate limiting, DDOS protection, and ip bans from various services each software uses.
- In other words, putting the *Arrs (Lidarr, Prowlarr, Radarr, Readarr, and Lidarr) behind a VPN can and will make the applications unusable in some cases due to the services not being accessible.
To be clear it is not a matter if VPNs will cause issues with the *Arrs, but when: image providers will block you and cloudflare is in front of most of *Arr servers (updates, metadata, etc.) and liable to block you too
- Many private trackers will ban you for using or accessing them (i.e. using Jackett or Prowlarr) via a VPN.
¶ Use of a VPN
- If a VPN is required and Docker is used it is recommended to use Hotio or Binhex's Download Client + VPN Containers.
- If a VPN is required and Docker is not used your VPN client must support split tunneling so only the required (Download Client) apps are behind the VPN.
- Many issues with accessing trackers can be resolved by using Google or Cloudflare's DNS servers in lieu of your ISP's DNS servers.
- In some cases (i.e. UK ISPs) you may need to put your torrent download client behind a VPN and Jackett/Prowlarr as follows:
- put Jackett behind the VPN and ensure split tunneling allows local access
- for Prowlarr configure your vpn client to provide a proxy and add the proxy in Settings => Indexers. Give the proxy a tag and any indexers that need to use it the same tag.
- If absolutely required and if your vpn does not provide a way to create a proxy you may put Prowlarr behind the VPN and ensure split tunneling allows local access.
¶ Radarr Searching & Downloading Common Problems
¶ Why can I not add a new movie to Radarr?
- Radarr uses The Movie Database (TMDb) for movie information and images like fanart, banners and backgrounds. Generally, there are a few reasons why you may not be able to add a movie:
- TMDb doesn't like special characters to be used when searching for movies through the API (which Radarr uses), so try searching a translated name, and/or without special characters.
- You can also add by TMDb ID or, if TMDb has it, the IMDb ID
- The movie hasn't been added to TMDb yet, follow their guide to get it added.
¶ Jackett shows more results than when manually searching
- This is usually due to searching Jackett differently than you do. See our troubleshooting article for more information.
¶ How does Radarr determine the year of a movie?
- Radarr gets metadata from TMDb
- Radarr uses the year of the oldest Theatrical Release date and the oldest Premier date for matching.
- Note that if a Theatrical Release does not exist then the logic will fall back to the oldest physical or digital release date.
- If a movie is missing a digital, physical, theatrical, or premier release date then TMDb should be updated.
- TMDb's Contribution Bible notes the following about their release types.
- Premiere - A premiere screening can take the form of a festival screening (e.g. TIFF) or a premiere event filled with the cast and crew in a big city (e.g. LA, London, Toronto).
- Theatrical - Can be used for the original release and any subsequent official releases. Used for wide or saturation releases. In the United States, 600-1,999 screens is considered a wide release and 2000+ is considered a saturation release.
- Theatrical (limited) - Limited theatrical release is a film distribution strategy of releasing a new film in a few theaters across a country, typically in major metropolitan markets. In the United States, the number of theaters is fewer than 600.
- Physical - Includes all VHS, DVD and Blu-ray releases.
- Digital - All and any relevant releases can be added including streaming platforms, VOD rental or purchase. Digital screenings including online film festivals and virtual cinema releases also count as digital releases.
¶ How does Radarr handle foreign movies or foreign titles?
TRaSH's Custom Format Language Guide may be useful for helping get movies in the language(s) you want.
Starting 2023-02-12, Radarr's metadata cache will begin to consider a Movie's Original Language to be the TMDb Spoken Language if and only if only 1 spoken language exists for the movie on TMDb; otherwise the movie's original TMDb language will be used.
- Search will use the Movie's Original Title, English Title, and Translated Title from whatever languages you have preferred in the movie's quality profile and any custom formats with scores in the quality profile greater than zero.
- Parsing (i.e. importing) looks for a match in all Translations and Alternative Titles.
- To get a movie in a foreign language set your movie's Quality Profile Language to Original (Movie's Original Language*), a specific language for that profile, or
Anyand create and score greater than 0 Custom Formats with Language Conditions to determine which language to grab. - Note that this does not include any indexer languages configured in the indexer's settings as
multi.- Note that starting with Radarr v4.1 of Radarr
multiis no longer assumed to include English - Users can adjust their Settings per Indexer to define what language(s)
multiindicates
- Note that starting with Radarr v4.1 of Radarr
Note that for indexers that support ID based searches - such as many Usenet indexers and many private Torrent trackers - text queries are not used if results are returned for an ID based search. Therefore the above about searching does not apply. Radarr will search the ID and if results are returned will not fall back to a name search. If you're missing results from your indexer then this is due to them having the release(s) associated with the incorrect movie id.
¶ How does Radarr handle "multi" in names?
- With Radarr v4.1+, Radarr assumes
multiis only the movie's language and NOT English as in previous versions.- Users can adjust their Settings per Indexer to define what language(s)
multiindicates
- Users can adjust their Settings per Indexer to define what language(s)
- Note that
multidefinitions only help for release parsing and not for foreign titles or movies searches.
¶ Help, Movie Added, But Not Searched
-
Radarr does not actively search for missing movies automatically. Instead, a periodic query of new posts is made to all indexers configured for RSS. When a wanted or cutoff unmet movie shows up in that list, it gets downloaded. This means that until a movie is posted (or reposted), it won’t get downloaded.
-
If you’re adding a movie that you want now, the best option is to check the “Start search for missing movie” box, to the left of the Add Movie (1) button. You can also go to the page for a movie you’ve added and click the magnifying glass “Search” (2) button or use the Wanted view to search for Missing or Cutoff Unmet movies.
- Add and Search for Movie when adding a movie
- Search an existing Movie
- Add and Search for Movie when adding a movie
¶ Jackett's /all Endpoint
-
The Jackett
/allendpoint is convenient, but that is its only benefit. Everything else is potential problems, so adding each tracker individually is required. Alternatively, you may wish to check out the Jackett & NZBHydra2 alternative Prowlarr -
January 1 2022 Update: Jackett
/allendpoint is no longer supported (e.g. warnings will occur) as of 4.0.0.5730 due to the fact it only causes issues. -
The Jackett /all endpoint is convenient, but that is its only benefit. Everything else is potential problems, so adding each tracker individually is now required.
-
Even Jackett's Devs says it should be avoided and should not be used.
-
Using the /all endpoint has no advantages, only disadvantages:
- you lose control over indexer specific settings (categories, search modes, etc.)
- mixing search modes (IMDB, query, etc.) might cause low-quality results
- indexer specific categories (>= 100000) cannot be used.
- slow indexers will slow down the overall result
- total results are limited to 1000
- if one of the trackers in /all returns an error, *Arr will disable it and now you do not get any results.
¶ Jackett /All Solutions
- Add each tracker in Jackett manually as an indexer in *Arr
- Check out Prowlarr which can sync indexers to *Arr and from the Lidarr/Radarr/Readarr development team.
- Check out NZBHydra2 which can sync indexers to *Arr. But do not use their single aggregate endpoint and use
multiif sync will be used.
¶ Why are there two files? | Why is there a file left in downloads?
This is expected. With a setup that supports hardlinks, double space will not be used. Below is how the Torrent Process works.
- Radarr will send a download request to your client, and associate it with a label or category name that you have configured in the download client settings. Examples: movies, tv, series, music, etc.
- Radarr will monitor your download clients active downloads that use that category name. This monitoring occurs via your download client's API.
- Completed files are left in their original location to allow you to seed the file (ratio or time can be adjusted in the download client or from within under the specific download client). When files are imported to your media folder will hardlink the file if supported by your setup or copy if not hardlinks are not supported.
- If the "Completed Download Handling - Remove Completed" option is enabled in Radarr's settings, Radarr will delete the original file and torrent from your download client, but only if the download client reports that seeding is complete and torrent is stopped (i.e. paused).
Hardlinks are enabled by default. A hardlink will allow not use any additional disk space. The file system and mounts must be the same for your completed download directory and your media library. If the hardlink creation fails or your setup does not support hardlinks then will fall back and copy the file.
¶ Why doesn't Radarr work behind a reverse proxy
- Starting with v3 Radarr has switched to .NET and a new webserver. In order for SignalR to work, the UI buttons to work, database changes to take, and other items. It requires the following addition to the location block for Radarr:
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $http_connection;
- Make sure you do not include
proxy_set_header Connection "Upgrade";as suggested by the nginx documentation. THIS WILL NOT WORK - See this ASP.NET Core issue
- If you are using a CDN like Cloudflare ensure websockets are enabled to allow websocket connections.
- If you have unexpected redirects, ensure your host header is being forwarded.