Radarr System
Please note that this information is only for Radarr V3.
Status
Health
This page contains a list of health checks errors. These health checks are periodically performed performed by Radarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.
System Warnings
- Branch is not a valid release branch
- The branch you have set is not a valid release branch. You will not receive updates. Please change to one of the current release branches.
- Update to .NET Core version
- Newer versions of Radarr are targeted for .NET. We will no longer be providing legacy mono builds after 3.2 is released. You are running one of these legacy builds but your platform supports .NET.
- Fixing Docker installs
- Re-pull your container
- Fixing Standalone installs
- Back-Up your existing configuration before the next step.
- This should only happen on Linux hosts. Do not install .net core runtime or SDK from microsoft. To remedy, download the correct build for your architecture. Please note that the links are for the
master
branch. If you are ondevelop
ornightly
you'll need to adjust/master/
in the URL. - Delete your existing binaries (contents or folder of /opt/Radarr) and replace with the contents of the
.tar.gz
you just downloaded. - DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.
YOU MUST DELETE THE OLD ONES FIRST.wget --content-disposition 'http://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64'
Download the .net binaries. The example is for a x64 (AMD64) installation.- For most users, this would be
.linux-core-x64.tar.gz
selected viaarch=x64
in the url. For ARM usearch=arm
and for ARM64 usearch=arm64
- For most users, this would be
sudo systemctl stop radarr
Stop Radarrsudo mv /opt/Radarr /opt/Radarr.old
Backup the old Binariestar -xvzf Radarr*.linux-core-x64.tar.gz
Extract the Radarr Tarballsudo mv Radarr/ /opt
Move the new Radarr Binariessudo chown -R radarr:radarr /opt/Radarr
Ensure Radarr has permissions to its directory, this assumes it runs as the userradarr
sudo rm -rf /opt/Radarr.old
Remove the old binariessudo rm -rf Radarr*.linux-core-x64.tar.gz
Remove the Tarball- Update your startup script in your systemd (
sudo nano -e /etc/systemd/system/radarr.service
) to callRadarr
instead of calling it with mono likemono --debug Radarr.exe
. In other words you want, as an example,/opt/Radarr/Radarr
and notmono --debug /opt/Radarr/Radarr
.- If Radarr doesn’t start, ensure you have the dependencies listed here installed.
systemctl daemon-reload
Reload the Systemd Filessudo systemctl start radarr.service
Restart Radarr
- Currently installed mono version is old and unsupported
- Radarr is written in .Net and requires Mono to run on very old ARM processors.
- Mono 5.20 is the absolute minimum for Radarr.
- The upgrade procedure for Mono varies per platform.
- Currently installed SQLite version is not supported
- Radarr stores its data in an SQLite database. The sqlite3 library installed on your system is too old. Radarr requires at least version 3.9.0. Note that Radarr uses
libsqlite3.so
which may or may not be contained in a sqlite3 upgrade package.
- Radarr stores its data in an SQLite database. The sqlite3 library installed on your system is too old. Radarr requires at least version 3.9.0. Note that Radarr uses
- New update is available
- Rejoice, the developers have released a new update. This generally means awesome new features and squashed piles of bugs (right?). Apparently you don’t have Auto-Updating enabled, so you’ll have to figure out how to update on your platform. Pressing the Install button on the System -> Updates page is probably a good starting point.
- (This warning will not appear if your current version is less than 14 days old)
- Cannot install update because startup folder is not writable by the user
- This means Radarr will be unable to update itself. You’ll have to update Radarr manually or set the permissions on Radarr’s Startup directory (the installation directory) to allow Radarr to update itself.
- Updating will not be possible to prevent deleting AppData on Update
- Radarr detected that AppData folder for your Operating System is located inside the directory that contains the Radarr binaries. Normally it would be
C:\ProgramData
for Windows and,~/.config
for linux. - Please look at System -> Info to see the current AppData & Startup directories.
- This means Radarr will be unable to update itself without risking data-loss.
- If you’re on linux, you’ll probably have to change the home directory for the user that is running Radarr and copy the current contents of the
~/.config/Radarr
directory to preserve your database.
- Radarr detected that AppData folder for your Operating System is located inside the directory that contains the Radarr binaries. Normally it would be
- Branch is for a previous version
- The update branch setup in Settings/General is for a previous version of Radarr, therefore the instance will not see correct update information in the System/Updates feed and may not receive new updates when released.
- Could not connect to signalR
- signalR drives the dynamic UI updates, so if your browser cannot connect to signalR on your server you won’t see any real time updates in the UI.
- The most common occurrence of this is use of a reverse proxy or cloudflare
- Cloudflare needs websockets enabled.
- Nginx requires the following addition to the location block for the app:
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 https://github.com/aspnet/AspNetCore/issues/17081
- Make sure you do not include
- For Apache2 reverse proxy, you need to enable the following modules:
proxy
,proxy_http
, andproxy_wstunnel
. Then, add this websocket tunnel directive to your vhost configuration:
- For Apache2 reverse proxy, you need to enable the following modules:
RewriteEngine On RewriteCond %{HTTP:Upgrade} =websocket [NC] RewriteRule /(.*) ws://127.0.0.1:7878/$1 [P,L]
- For Caddy (V1) use this:
- Note: you'll also need to add the websocket directive to your radarr configuration
- For Caddy (V1) use this:
proxy /radarr 127.0.0.1:7878 { websocket transparent }
- Failed to resolve the IP Address for the Configured Proxy Host
- Review your proxy settings and ensure they are accurate
- Ensure your proxy is up, running, and accessible
- Proxy Failed Test
- Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
- System Time is off by more than 1 day
- System time is off by more than 1 day. Scheduled tasks may not run correctly until the time is corrected
- Review your system time and ensure it is synced to an authoritative time server and accurate
- MediaInfo Library Could not be Loaded
- MediaInfo Library could not be loaded.
- PTP Indexer Settings Out of Date
- The following PassThePopcorn indexers have deprecated settings and should be updated.
- Mono Legacy TLS enabled
- Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option
- Mono and x86 builds are ending
- Mono and x86 builds will no longer be supported in the next build of the application. If you are receiving this error then you are running the mono version of the application or the x86 version. Unfortunately, due to increasing difficulting in development support for these legacy versions we will be discontinuing their support and thus releases for them going forward. Thus it is advised you upgrade to a supported Operating System that does not require neither x86 nor mono. You may also be able to explore using Docker for your needs.
Download Clients
- No download client is available
- A properly configured and enabled download client is required for Radarr to be able to download media. Since Radarr supports different download clients, you should determine which best matches your requirements. If you already have a download client installed, you should configure Radarr to use it and create a category. See Settings -> Download Client.
- Unable to communicate with download client
- Radarr was unable to communicate with the configured download client. Please verify if the download client is operational and double check the url. This could also indicate an authentication error.
- This is typically due to improperly configured download client. Things you can typically check:
- Your download clients IP Address if its on the same bare metal machine this is typically
127.0.0.1
- The Port number of that your download client is using these are filled out with the default port number but if you've changed it you'll need to have the same one entered into Radarr.
- Ensure SSL encryption is not turned on if you're using both your Radarr instance and your download client on a local network. See the SSL FAQ entry for more information.
- Your download clients IP Address if its on the same bare metal machine this is typically
- One or more of your download clients is not responding to requests made by Radarr. Therefore Radarr has decided to temporarily stop querying the download client on it’s normal 1 minute cycle, which is normally used to track active downloads and import finished ones. However, Radarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
- You should inspect System->Logs to see what the reason is for the failures.
- If you no longer use this download client, disable it in Radarr to prevent the errors.
- Enable Completed Download Handling
- Radarr requires Completed Download Handling to be able to import files that were downloaded by the download client. It is recommended to enable Completed Download Handling.
- (Completed Download Handling is enabled by default for new users.)
- Docker bad remote path mapping
- This error is typically associated with bad docker paths within either your download client or Radarr
- An example of this would be:
- Download client:
Download Path: /downloads:/mnt/user/downloads
- Radarr:
Download Path: /data:/mnt/user/downloads
- Within this example the download client places its downloads into
/downloads
and therefore tells Radarr when its complete that the finished movie is in/downloads
. Radarr then comes along and says "Okay, cool, let me check in/downloads
" Well, inside Radarr you did not allocate a/downloads
path you allocated a/data
path so it throws this error. - The easiest fix for this is CONSISTENCY if you use one scheme in your download client, use it across the board.
- Team Radarr is a big fan of simply using
/data
.- Download client:
/data:/mnt/user/data
- Radarr:
/data:/mnt/user/data
- Now within the download client you can specify where in
/data
you'd like to place your downloads, now this varies depending on the client but you should be able to tell it "Yeah download client place my files into."/data/torrents (or usenet)/movies
and since you used/data
in Radarr when the download client tells Radarr it's done Radarr will come along and say "Sweet, I have a/data
and I also can see/torrents (or usenet)/movies
all is right in the world."
- Download client:
- Download client:
- There are many great write ups by some very talented people one on our wiki Docker Guide and the other by TRaSH with his How To Set Up Hardlinks and Atomic-Moves Now these guides place heavy emphasis on Hardlinks and Atomic moves, but the general concept of containers and how path mapping works is the core of these discussions.
- An example of this would be:
- This error is typically associated with bad docker paths within either your download client or Radarr
See TRaSH's Remote Path Guide for more information.
- Downloading into Root Folder
- Within the application, a root folder is defined as the configured media library folder. You're downloading directly into your root (library) folder. This frequently causes issues and is not advised. To fix this change your download client so it is not placing downloads within your root folder. Please note that this check looks at all defined/configured root folders added not only root folders currently in use.
- Bad Download Client Settings
- The location your download client is downloading files to is causing problems. Check the logs for further information. This may be permissions or attempting to go from windows to linux or linux to windows without a remote path map.
- Bad Remote Path Mapping
- The location your download client is downloading files to is causing problems. Check the logs for further information. This may be permissions or attempting to go from windows to linux or linux to windows without a remote path map. See TRaSH's Remote Path Guide for more information.
- Permissions Error
- Radarr or the user radarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.
- Remote File was removed part way through processing
- A file accessible via a remote path map appears to have been removed prior to processing completing.
- Remote Path is Used and Import Failed
- Check your logs for more info; Refer to our Troubleshooting Guides
Completed/Failed Download Handling
- Completed Download Handling is disabled
- (This warning is only generated for existing users before when the Completed Download Handling feature was implemented. This feature is disabled by default to ensure the system continued to operate as expected for current configurations.)
- It’s recommended to use Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients. With it, Radarr will only import a download once the download client reports it as ready.
- If you wish to enable Completed Download Handling you should verify the following: * Warning: Completed Download Handling only works properly if the download client and Radarr are on the same machine since it gets the path to be imported directly from the download client otherwise a remote map is needed.
Indexers
- No indexers available with automatic search enabled, Radarr will not provide any automatic search results
- Simply put you do not have any of your indexers set to allow automatic searches
- Go into Settings > Indexers, select an indexer you'd like to allow Automatic Searches and then click save.
- Simply put you do not have any of your indexers set to allow automatic searches
- No indexers available with RSS sync enabled, Radarr will not grab new releases automatically
- So Radarr uses the RSS feed to pick up new releases as they come along. More info on that here
- To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
- No indexers are enabled
- Radarr requires indexers to be able to discover new releases. Please read the wiki on instructions how to add indexers.
- Enabled indexers do not support searching
- None of the indexers you have enabled support searching. This means Radarr will only be able to find new releases via the RSS feeds. But searching for movies (either Automatic Search or Manual Search) will never return any results. Obviously, the only way to remedy it is to add another indexer.
- No indexers avaiable with Interactive Search Enabled"
- None of the indexers you have enabled support interactive searching. This means the application will only be able to find new releases via the RSS feeds or an automatic search.
- Errors occurs while Radarr tried to use one of your indexers. To limit retries, Radarr will not use the indexer for an increasing amount of time (up to 24h).
- This mechanism is triggered if Radarr was unable to get a response from the indexer (could be dns, connection, authentication or indexer issue), or unable to fetch the nzb/torrent file from the indexer. Please inspect the logs to determine what kind of error causes the problem.
- You can prevent the warning by disabling the affected indexer.
- Run the Test on the indexer to force Radarr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.
Movie Folders
- Missing root folder
- This error is typically identified if a Movie is looking for a root folder but that root folder is no longer available.
- If you would like to remove this warning simply find the movie that is still using the old root folder and edit it to the correct root Folder
- Easiest way to find this is to go to the Movies (Library) Tab
- Create a custom filter with the old root folder path
- Select mass edit on the top bar and from the Root Paths drop down select the new root path that you want these movies to be moved to.
- Next you'll receive a pop-up that states Would you like to move the movie folders to '<root path>' ? This will also state This will also rename the movie folder per the movie folder format in settings. Simply select No if the you do not want Radarr to move your files
- If you would like to remove this warning simply find the movie that is still using the old root folder and edit it to the correct root Folder
- This error is typically identified if a Movie is looking for a root folder but that root folder is no longer available.
Movies
- Movie was removed from TMDb
- The movie is linked to a TMDb Id that was deleted from TMDb, usually because it was a duplicate, wasn't a movie or changed ID for some other reason. Deleted movies will not receive any updates and should be corrected by the user to ensure continued functionality. Remove the movie from Radarr without deleting the files, then try to re-add it. If it doesn't show up in a search, check Radarr because it might be a TV miniseries like Stephen King's It.
- You can find and edit deleted movies by creating a custom filter using the following steps: 1. Click Movies from the left menu 2. Click the dropdown on Filter and select “Custom Filter” 3. Enter a label, for example “Deleted Movies” 4. Make the filter as follows: Status is Deleted 5. Click save and select the newly created filter from the filter dropdown menu
- The movie is linked to a TMDb Id that was deleted from TMDb, usually because it was a duplicate, wasn't a movie or changed ID for some other reason. Deleted movies will not receive any updates and should be corrected by the user to ensure continued functionality. Remove the movie from Radarr without deleting the files, then try to re-add it. If it doesn't show up in a search, check Radarr because it might be a TV miniseries like Stephen King's It.
- Typically this simply means that Radarr is no longer able to communicate via API or via logging in to your chosen list provider. Your best bet if the problem persists is to contact them in order to rule them out, as their systems maybe overloaded from time to time.
Disk Space
- This section will show you available disk space
- In docker this can be tricky as it will typically show you the available space within your Docker image
About
This will tell you about your current install of Radarr
More Info
- Home Page: Radarr's home page
- Wiki: You're here already
- Reddit: r/radarr
- Discord: Join our discord
- Donations: If you're feeling generous and would like to donate click here
- Donations to Sonarr: If you're feeling generous and would like to donate to the project that started it all click here
- Source: Github
- Feature Requests: Got a great idea drop it here
Tasks
Scheduled
This page lists all scheduled tasks that Radarr runs
- Application Check Update - This will run every on the displayed schedule in the UI, checking to see if Radarr is on the most current version then triggering the update script to update Radarr. Settings-> Update
- Note: If on Docker this will not update your container as a new image will need to be downloaded.
- Backup - This will run a backup of your Radarr's database on a set schedule more details on this can be found here. More information about backups can be found System -> Backups.
- Check Health - Check Health will run on the displayed schedule in the UI checking the overall health of your Radarr. To see a list of possible health related issues see the Wiki Entry on Health Checks.
- Clean Up Recycle Bin - The recycling bin will be cleared out on the displayed schedule in the UI. This will only be used if the recycling bin is set in File Management
- Housekeeping - On the displayed schedule in the UI this will dust out all the cobwebs, sweeps and vacuums the floors, mops, shines, and even makes nice neat little folded notes just for you. But does not take out the trash. That it just was not paid enough for.
- Import List Sync - On the displayed schedule in the UI this will run your Lists and import any possible new movies. More info about lists can be found Settings -> Lists.
- Messaging Cleanup - On the displayed schedule in the UI this cleans up those messages that appear in the bottom left corner of Radarr
- Refresh Monitored Downloads - This goes through and refreshes the downloads queue located under Activity. Essentially pinging your download client to check for finished downloads.
- Refresh Movie - This goes through and refreshes all the metadata for all monitored and unmonitored movies
- Rss Sync - This will run the RSS Sync. This can be changed in settings -> options. More information on the RSS function can be found on our FAQ
- Note: All these tasks can be ran manually outside their scheduled times by hitting the icon to the far right of each of the tasks.
Queue
The queue will show you upcoming tasks as well as a history of recently ran tasks as well as how long those tasks took.
Backup
- Note: This section will be more tailored to the buttons and overall point of the page.
However, if you're looking for how to back/restore your Radarr instance click here.
- Within the Backup section you'll be presented with previous backups (unless you have a fresh install that hasn't made any backups).
- Here you'll have two options at the top of the screen
- Backup Now - This option will trigger a manual backup of your Radarr's database
- Restore Backup - This will open a new screen to restore from a previous backup
- By selecting Choose File this will prompt your browser to open a dialog box to restore from a Radarr
Zip
backup
- By selecting Choose File this will prompt your browser to open a dialog box to restore from a Radarr
- Finally if you have any previous backups and would like to download them from Radarr to be placed in a non standard location you simply can select one of these files to download them
- Off to the right of each of the previous download you have two options.
- One - To restore from a previous backup - This will open a new window to confirm you want to restore from this backup
- Two - To delete a previous backup
- Off to the right of each of the previous download you have two options.
Updates
- The update screen will show the past 5 updates that have been made as well as the current version you are on.
- This page will also display the update notes from the Devs telling you what has been fixed or added to Radarr (Rejoice!)
- A
Maintenance Release
contains bug fixes and other various improvements. Take a look at the commit history for specifics.
Events
The events tab will show you what has been happening within your Radarr. This can be used to diagnose some light issues. However, this does not replace Trace Logs discussed in Logging. Events are the equivalent of INFO
Logs.
- Components - This column will tell you what component within Radarr has been triggered
- Message - This column will tell you what message as been sent from the component from the previous column.
- Gear Icon - This option will allow you to change how many Components/Messages are displayed per page (Default is 50)
- Options at the top of the page
- Refresh - This option will refresh the current page, pulling a new events log
- Clear - This will clear the current events log allowing you to start from fresh
Log Files
This page will allow you to download and see what current log files are available for Radarr
- On the top row there are several options to allow you to control your log files.
- The top row on the far left there is a dropdown that will allow you to switch from Log files and Updater Log Files
- Log Files - The bread and butter of any support issue more on log files can be found here.
- Updater Log Files - This will show the log files associated with Radarr's updater script
- Note: If you're on docker this will be empty as you should be updating by downloading a new docker image
- Refresh - This will refresh the current page and display any newly created logs
- Delete - This will clear all logs allowing you to start from fresh
- File Name - This will display the file name associated with the log
- Last Written - This is the local time that this particular log file was written to.
- Radarr uses rolling log files limited to 1MB each. The current log file is always radarr.txt, for the the other files radarr.0.txt is the next newest (the higher the number the older it is) up to 51 log files total. This log file contains fatal, error, warn, and info entries.
- When Debug log level is enabled, additional radarr.debug.txt rolling log files will be present, up to 51 files. This log files contains fatal, error, warn, info, and debug entries. It usually covers a ~40h period.
- When Trace log level is enabled, additional radarr.trace.txt rolling log files will be present, up to 51 files. This log files contains fatal, error, warn, info, debug, and trace entries. Due to trace verbosity it only covers a couple of hours at most.
- The top row on the far left there is a dropdown that will allow you to switch from Log files and Updater Log Files