Difference between revisions of "System status"

From Servarr
(root folder updates....)
 
(82 intermediate revisions by 4 users not shown)
Line 21: Line 21:
 
===== Radarr =====
 
===== Radarr =====
 
<section begin=radarr_system_status_health_system_warnings />
 
<section begin=radarr_system_status_health_system_warnings />
 +
*<span id="branch_is_not_a_valid_release_branch">'''[[#branch_is_not_a_valid_release_branch|Branch is not a valid release branch]]'''</span>
 +
** 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.
 +
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
** Newer versions of Radarr are targeted for .NET Core. We provide legacy mono builds for those platforms that cannot use .NET Core. You are running one of these legacy builds but your platform supports .NET Core.
+
** 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
 
** Fixing Docker installs
 
*** Re-pull your container
 
*** Re-pull your container
 
** Fixing Standalone installs
 
** Fixing Standalone installs
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture:
+
***<span style="color:#ff0000">'''[[Radarr_FAQ#how_do_i_backup_restore_my_Radarr| Back-Up your existing configuration]]'''</span> before the next step.
****[https://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64 x64]
+
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture. Please note that the links are for the <code>master</code> branch. If you are on <code>develop</code> or <code>nightly</code> you'll need to adjust <code>/master/</code> in the URL.
****[https://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm64 arm64]
+
*** '''Delete your existing binaries (contents or folder of /opt/Radarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
****[https://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm arm]
 
***<span style="color:#ff0000">'''Back-Up your existing configuration'''</span> before the next step.
 
*** '''Delete your existing binaries' (contents or folder of /opt/Radarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
 
 
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''.</span>  
 
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''.</span>  
**** Update your startup script to call <code>Radarr</code> instead of calling it with mono like <code>mono --debug Radarr.exe</code>. In other words you want, as an example, <code>/opt/Radarr/Radarr</code> and '''not''' <code>mono  --debug /opt/Radarr/Radarr</code>.
+
****<code>wget --content-disposition <nowiki>'http://radarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64'</nowiki></code> Download the .net binaries. The example is for a x64 (AMD64) installation.
*** If Radarr doesn’t start, ensure you have the dependencies listed [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux here] installed.
+
***** For most users, this would be <code>.linux-core-x64.tar.gz</code> selected via <code>arch=x64</code> in the url. For ARM use <code>arch=arm</code> and for ARM64 use <code>arch=arm64</code>
 +
****<code> sudo systemctl stop radarr</code> Stop Radarr
 +
****<code> sudo mv /opt/Radarr /opt/Radarr.old</code> Backup the old Binaries
 +
**** <code> tar -xvzf Radarr*.linux-core-x64.tar.gz</code> Extract the Radarr Tarball
 +
**** <code> sudo mv Radarr/ /opt</code> Move the new Radarr Binaries
 +
**** <code> sudo chown -R radarr:radarr /opt/Radarr</code> Ensure Radarr has permissions to its directory, this assumes it runs as the user <code>radarr</code>
 +
**** <code> sudo rm -rf /opt/Radarr.old</code> Remove the old binaries
 +
**** <code> sudo rm -rf Radarr*.linux-core-x64.tar.gz</code> Remove the Tarball
 +
**** Update your startup script in your systemd (<code> sudo nano -e /etc/systemd/system/radarr.service</code>) to call <code>Radarr</code> instead of calling it with mono like <code>mono --debug Radarr.exe</code>. In other words you want, as an example, <code>/opt/Radarr/Radarr</code> and '''not''' <code>mono  --debug /opt/Radarr/Radarr</code>.
 +
***** If Radarr doesn’t start, ensure you have [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux the dependencies listed here] installed.
 +
****<code> systemctl daemon-reload</code> Reload the Systemd Files
 +
****<code> sudo systemctl start radarr.service</code> Restart Radarr
  
*<span id="mono_version_is_less_than_5_8_upgrade_for_improved_stability">'''[[#mono_version_is_less_than_5_8_upgrade_for_improved_stability|Mono version is less than 5.8, upgrade for improved stability]]'''</span>
+
* <span id="currently_installed_mono_version_is_old_and_unsupported">'''[[#currently_installed_mono_version_is_old_and_unsupported|Currently installed mono version is old and unsupported]]'''</span>
** Radarr is written in .Net and requires Mono to run. Versions of 3.10 and above resolved various stability issues we experienced in the past and is considered the minimum supported version.<br />
+
** Radarr is written in .Net and requires Mono to run on very old ARM processors.  
** Mono version 5.x and higher are also available and provides a better experience on certain platforms.
+
** Mono 5.20 is the absolute minimum for Radarr.
** See "Update to .NET Core version above"
+
** The upgrade procedure for Mono varies per platform.
  
 
*<span id="currently_installed_sqlite_version_is_not_supported">'''[[#currently_installed_sqlite_version_is_not_supported|Currently installed SQLite version is not supported]]'''</span>
 
*<span id="currently_installed_sqlite_version_is_not_supported">'''[[#currently_installed_sqlite_version_is_not_supported|Currently installed SQLite version is not supported]]'''</span>
** 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.
+
** 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 <code>libsqlite3.so</code> which may or may not be contained in a sqlite3 upgrade package.
  
 
*<span id="new_update_is_available">'''[[#new_update_is_available|New update is available]]'''</span>
 
*<span id="new_update_is_available">'''[[#new_update_is_available|New update is available]]'''</span>
Line 60: Line 71:
 
** 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.
 
** 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.
  
*<span id="could_not_connect_to_signalr">'''[[#could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
+
*<span id="Could_not_connect_to_signalr">'''[[#Could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
 
** 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.
 
** 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 on V3 combined with an nginx reverse proxy. Nginx requires the following addition to the location block for radarr:
+
** The most common occurrence of this is use of a reverse proxy or cloudflare
proxy_http_version 1.1;
+
** Cloudflare needs websockets enabled.
proxy_set_header Upgrade $http_upgrade;
+
** Nginx requires the following addition to the location block for the app:
proxy_set_header Connection $http_connection;
+
  proxy_http_version 1.1;
 +
  proxy_set_header Upgrade $http_upgrade;
 +
  proxy_set_header Connection $http_connection;
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** See https://github.com/aspnet/AspNetCore/issues/17081
 
** See https://github.com/aspnet/AspNetCore/issues/17081
** For apache reverse proxy you need to add to the configuration:
+
 
  Include /etc/apache2/mods-available/proxy_wstunnel.load
+
** For Apache2 reverse proxy, you need to enable the following modules: <code>proxy</code>, <code>proxy_http</code>, and <code>proxy_wstunnel</code>. Then, add this websocket tunnel directive to your vhost configuration:
  ProxyPass "/socket" "ws://127.0.0.1:7878/socket"
+
  RewriteEngine On
  ProxyPassReverse "/socket" "ws://127.0.0.1:7878/socket"
+
  RewriteCond %{HTTP:Upgrade} =websocket [NC]
* For Caddy (V1) use this:
+
  RewriteRule /(.*) ws://127.0.0.1:7878/$1 [P,L]
** Note: you'll also need to add the websocket directive to your radarr configuration
+
** For Caddy (V1) use this:
 +
*** Note: you'll also need to add the websocket directive to your radarr configuration
 
   proxy /radarr 127.0.0.1:7878 {
 
   proxy /radarr 127.0.0.1:7878 {
 
       websocket
 
       websocket
 
       transparent
 
       transparent
 
   }
 
   }
 +
 +
*<span id="proxy_failed_resolve_ip">'''[[#proxy_failed_resolve_ip|Failed to resolve the IP Address for the Configured Proxy Host]]'''</span>
 +
** Review your proxy settings and ensure they are accurate
 +
** Ensure your proxy is up, running, and accessible
 +
 +
*<span id="proxy_failed_test">'''[[#proxy_failed_test|Proxy Failed Test]]'''</span>
 +
** Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
 +
 +
*<span id="system_time_off">'''[[#system_time_off|System Time is off by more than 1 day]]'''</span>
 +
** 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
 +
 +
*<span id="mediainfo_not_loaded">'''[[#mediainfo_not_loaded|MediaInfo Library Could not be Loaded]]'''</span>
 +
** MediaInfo Library could not be loaded.
 +
 +
*<span id="ptp_settings_old">'''[[#ptp_settings_old|PTP Indexer Settings Out of Date]]'''</span>
 +
** The following PassThePopcorn indexers have deprecated settings and should be updated.
 +
 +
*<span id="mono_tls_legacy">'''[[#mono_tls_legacy|Mono Legacy TLS enabled]]'''</span>
 +
** Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option
 +
 +
*<span id="mono_support_end_of_life">'''[[#mono_support_end_of_life|Mono and x86 builds are ending]]'''</span>
 +
** 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.
 +
 
<section end=radarr_system_status_health_system_warnings />
 
<section end=radarr_system_status_health_system_warnings />
  
 
===== Sonarr =====
 
===== Sonarr =====
 
<section begin=sonarr_system_status_health_system_warnings />
 
<section begin=sonarr_system_status_health_system_warnings />
 +
*<span id="branch_is_not_a_valid_release_branch">'''[[#branch_is_not_a_valid_release_branch|Branch is not a valid release branch]]'''</span>
 +
** 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.
 +
 
* <span id="currently_installed_net_framework_is_old_and_unsupported">'''[[#currently_installed_net_framework_is_old_and_unsupported|Currently installed .Net Framework is old and unsupported]]</span>'''
 
* <span id="currently_installed_net_framework_is_old_and_unsupported">'''[[#currently_installed_net_framework_is_old_and_unsupported|Currently installed .Net Framework is old and unsupported]]</span>'''
 
** Sonarr uses the .Net Framework. We need to build Sonarr against the lowest supported version still used by our users. Occasionally we increase the version we build against to be able to utilize new features. Apparently you haven't applied the appropriate Windows updates in a while and need to upgrade .Net to be able to use newer versions of Sonarr.
 
** Sonarr uses the .Net Framework. We need to build Sonarr against the lowest supported version still used by our users. Occasionally we increase the version we build against to be able to utilize new features. Apparently you haven't applied the appropriate Windows updates in a while and need to upgrade .Net to be able to use newer versions of Sonarr.
** Upgrading the .Net Framework is very straightforward on Windows, although it often requires a restart. Please follow the instructions here: https://dotnet.microsoft.com/download/dotnet-framework.
+
** Upgrading the .Net Framework is very straightforward on Windows, although it often requires a restart. [https://dotnet.microsoft.com/download/dotnet-framework Please follow the instructions here].
  
 
* <span id="currently_installed_net_framework_is_supported_but_upgrading_is_recommended">'''[[#currently_installed_net_framework_is_supported_but_upgrading_is_recommended|Currently installed .Net Framework is supported but upgrading is recommended]]'''</span>
 
* <span id="currently_installed_net_framework_is_supported_but_upgrading_is_recommended">'''[[#currently_installed_net_framework_is_supported_but_upgrading_is_recommended|Currently installed .Net Framework is supported but upgrading is recommended]]'''</span>
 
** Sonarr uses the .Net Framework. We need to build Sonarr against the lowest supported version still used by our users. Upgrading to newer versions allows us to build against newer versions and use new Framework features.
 
** Sonarr uses the .Net Framework. We need to build Sonarr against the lowest supported version still used by our users. Upgrading to newer versions allows us to build against newer versions and use new Framework features.
** Upgrading the .Net Framework is very straightforward on Windows, although it often requires a restart. Please follow the instructions here: https://dotnet.microsoft.com/download/dotnet-framework.
+
** Upgrading the .Net Framework is very straightforward on Windows, although it often requires a restart. [https://dotnet.microsoft.com/download/dotnet-framework Please follow the instructions here].
  
 
* <span id="currently_installed_mono_version_is_old_and_unsupported">'''[[#currently_installed_mono_version_is_old_and_unsupported|Currently installed mono version is old and unsupported]]'''</span>
 
* <span id="currently_installed_mono_version_is_old_and_unsupported">'''[[#currently_installed_mono_version_is_old_and_unsupported|Currently installed mono version is old and unsupported]]'''</span>
 
** Sonarr is written in .Net and requires Mono to run. Various versions of Sonarr have different minimum versions of Mono to operate correctly. The ideal version of Mono varies per platform.<br />
 
** Sonarr is written in .Net and requires Mono to run. Various versions of Sonarr have different minimum versions of Mono to operate correctly. The ideal version of Mono varies per platform.<br />
** Mono 5.4 is the absolute minimum for Sonarr v3 but Mono 5.20 is currently recommended.
+
** Mono 5.8 is the absolute minimum for Sonarr, but Mono 5.20 is currently recommended.
 
** The upgrade procedure for Mono varies per platform.
 
** The upgrade procedure for Mono varies per platform.
  
Line 107: Line 148:
  
 
* <span id="updating_will_not_be_possible_to_prevent_deleting_appdata_on_update">'''[[#updating_will_not_be_possible_to_prevent_deleting_appdata_on_update|Updating will not be possible to prevent deleting AppData on Update]]'''</span>
 
* <span id="updating_will_not_be_possible_to_prevent_deleting_appdata_on_update">'''[[#updating_will_not_be_possible_to_prevent_deleting_appdata_on_update|Updating will not be possible to prevent deleting AppData on Update]]'''</span>
**Sonarr detected that AppData folder for your Operating System is located inside the directory that contains the Sonarr binaries. Normally it would be <code>C:\ProgramData</code> for Windows and, <code>~/.config</code> for linux.<br />
+
** Sonarr detected that AppData folder for your Operating System is located inside the directory that contains the Sonarr binaries. Normally it would be <code>C:\ProgramData</code> for Windows and, <code>~/.config</code> for linux.<br />
 
** Please look at System -&gt; About to see the current AppData &amp; Startup directories.
 
** Please look at System -&gt; About to see the current AppData &amp; Startup directories.
 
** This means Sonarr will be unable to update itself without risking data-loss.
 
** This means Sonarr 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 Sonarr and copy the current contents of the <code>~/.config/Sonarr</code> directory to preserve your database.
 
** If you're on linux, you'll probably have to change the home directory for the user that is running Sonarr and copy the current contents of the <code>~/.config/Sonarr</code> directory to preserve your database.
 +
* <span id="package_maintainer_message">'''[[#package_maintainer_message|Package Maintainer Message]]'''</span>
 +
** Please refer to the specific message your package maintainer is indicating to you.  This is not a Sonarr issue. For additional information, refer to your package maintainer.  Your package maintainer can be found in System -> Status -> About.  Note that this includes docker and your package maintainer is whomever maintains your docker image.
 +
 +
*<span id="proxy_failed_resolve_ip">'''[[#proxy_failed_resolve_ip|Failed to resolve the IP Address for the Configured Proxy Host]]'''</span>
 +
** Review your proxy settings and ensure they are accurate
 +
** Ensure your proxy is up, running, and accessible
 +
 +
*<span id="proxy_failed_test">'''[[#proxy_failed_test|Proxy Failed Test]]'''</span>
 +
** Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
 +
 +
*<span id="system_time_off">'''[[#system_time_off|System Time is off by more than 1 day]]'''</span>
 +
** 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
 +
 +
*<span id="mediainfo_not_loaded">'''[[#mediainfo_not_loaded|MediaInfo Library Could not be Loaded]]'''</span>
 +
** MediaInfo Library could not be loaded.
 +
 +
*<span id="mono_tls_legacy">'''[[#mono_tls_legacy|Mono Legacy TLS enabled]]'''</span>
 +
** Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option
  
*<span id="could_not_connect_to_signalr">'''[[#could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
 
** 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 on V3 combined with an nginx reverse proxy. Nginx requires the following addition to the location block for radarr:
 
*::<code>proxy_http_version 1.1;</code>
 
*::<code>proxy_set_header Upgrade $http_upgrade;</code>
 
*::<code>proxy_set_header Connection $http_connection;</code>
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** See https://github.com/aspnet/AspNetCore/issues/17081
 
** For apache reverse proxy you need to add to the configuration:
 
*::<code>Include /etc/apache2/mods-available/proxy_wstunnel.load</code>
 
*::<code>ProxyPass "/socket" "ws://127.0.0.1:7878/socket"</code>
 
*::<code>ProxyPassReverse "/socket" "ws://127.0.0.1:7878/socket"</code>
 
 
<section end=sonarr_system_status_health_system_warnings />
 
<section end=sonarr_system_status_health_system_warnings />
  
 
===== Lidarr =====
 
===== Lidarr =====
 
<section begin=lidarr_system_status_health_system_warnings />
 
<section begin=lidarr_system_status_health_system_warnings />
 +
*<span id="branch_is_not_a_valid_release_branch">'''[[#branch_is_not_a_valid_release_branch|Branch is not a valid release branch]]'''</span>
 +
** 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.
 +
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
** Newer versions of Lidarr are targeted for .NET Core. We provide legacy mono builds for those platforms that cannot use .NET Core. You are running one of these legacy builds but your platform supports .NET Core.
+
** Newer versions of Lidarr are targeted for .NET. We will soon no longer provide legacy mono builds for those platforms that cannot use .NET. You are running one of these legacy builds but your platform supports .NET.
 
** Fixing Docker installs
 
** Fixing Docker installs
 
*** Re-pull your container
 
*** Re-pull your container
 
** Fixing Standalone installs
 
** Fixing Standalone installs
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture:
 
****[https://lidarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64 x64]
 
****[https://lidarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm64 arm64]
 
****[https://lidarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm arm]
 
 
***<span style="color:#ff0000">'''Back-Up your existing configuration'''</span> before the next step.
 
***<span style="color:#ff0000">'''Back-Up your existing configuration'''</span> before the next step.
*** '''Delete your existing binaries' (contents or folder of /opt/Lidarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
+
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture. Please note that the links are for the <code>develop</code> branch. If you are on <code>nightly</code> you'll need to adjust <code>/develop/</code> in the URL.
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''.</span>  
+
***'''Delete your existing binaries (contents or folder of /opt/Lidarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
**** Update your startup script to call <code>Lidarr</code> instead of calling it with mono like <code>mono --debug Lidarr.exe</code>. In other words you want, as an example, <code>/opt/Lidarr/Lidarr</code> and '''not''' <code>mono  --debug /opt/Lidarr/Lidarr</code>.
+
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''</span>
*** If Lidarr doesn’t start, ensure you have the dependencies listed [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux here] installed
+
****<code>wget --content-disposition <nowiki>'http://lidarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64'</nowiki></code> Download the .net binaries. The example is for a x64 (AMD64) installation.
 +
***** For most users, this would be <code>.linux-core-x64.tar.gz</code> selected via <code>arch=x64</code> in the url. For ARM use <code>arch=arm</code> and for ARM64 use <code>arch=arm64</code>
 +
****<code> sudo systemctl stop lidarr.service</code> Stop Lidarr
 +
****<code> sudo mv /opt/Lidarr /opt/Lidarr.old</code> Backup the old Binaries
 +
****<code> tar -xvzf Lidarr*.linux-core-x64.tar.gz</code> Extract the Lidarr Tarball
 +
****<code> sudo mv Lidarr/ /opt</code> Move the new Lidarr Binaries
 +
****<code> sudo chown -R lidarr:lidarr /opt/Lidarr</code> Ensure Lidarr has permissions to its directory, this assumes it runs as the user <code>lidarr</code>
 +
****<code> sudo rm -rf /opt/Lidarr.old</code> Remove the old binaries
 +
****<code> sudo rm -rf Lidarr*.linux-core-x64.tar.gz</code> Remove the Tarball
 +
**** Update your startup script (<code> sudo nano -e /etc/systemd/system/lidarr.service</code>) to call <code>Lidarr</code> instead of calling it with mono like <code>mono --debug Lidarr.exe</code>. In other words you want, as an example, <code>/opt/Lidarr/Lidarr</code> and '''not''' <code>mono  --debug /opt/Lidarr/Lidarr</code>.
 +
***** If Lidarr doesn’t start, ensure you have [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux the dependencies listed here] installed
 +
****<code> systemctl daemon-reload</code> Reload the Systemd Files
 +
****<code> sudo systemctl start lidarr.service</code> Restart Lidarr
  
 
*<span id="mono_version_is_less_than_5_8_upgrade_for_improved_stability">'''[[#mono_version_is_less_than_5_8_upgrade_for_improved_stability|Mono version is less than 5.8, upgrade for improved stability]]'''</span>
 
*<span id="mono_version_is_less_than_5_8_upgrade_for_improved_stability">'''[[#mono_version_is_less_than_5_8_upgrade_for_improved_stability|Mono version is less than 5.8, upgrade for improved stability]]'''</span>
** Lidarr is written in .Net and requires Mono to run. Versions of 3.10 and above resolved various stability issues we experienced in the past and is considered the minimum supported version.<br />
+
** Lidarr is written in .Net and requires Mono to run on very old ARM processors.  
** Mono version 5.x and higher are also available and provides a better experience on certain platforms.
+
** Mono 5.20 is the absolute minimum for Lidarr.
 +
** The upgrade procedure for Mono varies per platform..
 
** See "Update to .NET Core version above"
 
** See "Update to .NET Core version above"
  
Line 157: Line 217:
 
*<span id="branch_is_for_a_previous_version">'''[[#branch_is_for_a_previous_version|Branch is for a previous version]]'''</span>
 
*<span id="branch_is_for_a_previous_version">'''[[#branch_is_for_a_previous_version|Branch is for a previous version]]'''</span>
 
** The update branch setup in Settings/General is for a previous version of Lidarr, therefore the instance will not see correct update information in the System/Updates feed and may not receive new updates when released.
 
** The update branch setup in Settings/General is for a previous version of Lidarr, therefore the instance will not see correct update information in the System/Updates feed and may not receive new updates when released.
**'''Note:''' Please note that v0.2 will only have critical bugs resolved as of August 2020. Any additional development or features will be solely in V3. Each push to the “develop” branch creates a build on “nightly” release channel (release channel is the “branch” within Lidarr’s settings), once we push a build to Github it will show up on “develop” release channel.
 
  
*<span id="could_not_connect_to_signalr">'''[[#could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
+
*<span id="Could_not_connect_to_signalr">'''[[#Could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
 
** 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.
 
** 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 on V3 combined with an nginx reverse proxy. Nginx requires the following addition to the location block for Lidarr:
+
** The most common occurrence of this is use of a reverse proxy or cloudflare
*::<code>proxy_http_version 1.1;</code>
+
** Cloudflare needs websockets enabled.
*::<code>proxy_set_header Upgrade $http_upgrade;</code>
+
** Nginx requires the following addition to the location block for the app:
*::<code>proxy_set_header Connection $http_connection;</code>
+
  proxy_http_version 1.1;
 +
  proxy_set_header Upgrade $http_upgrade;
 +
  proxy_set_header Connection $http_connection;
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** See https://github.com/aspnet/AspNetCore/issues/17081
 
** See https://github.com/aspnet/AspNetCore/issues/17081
** For apache reverse proxy you need to add to the configuration:
+
** For Apache2 reverse proxy, you need to enable the following modules: <code>proxy</code>, <code>proxy_http</code>, and <code>proxy_wstunnel</code>. Then, add this websocket tunnel directive to your vhost configuration:
*::<code>Include /etc/apache2/mods-available/proxy_wstunnel.load</code>
+
RewriteEngine On
*::<code>ProxyPass "/socket" "ws://127.0.0.1:7878/socket"</code>
+
RewriteCond %{HTTP:Upgrade} =websocket [NC]
*::<code>ProxyPassReverse "/socket" "ws://127.0.0.1:7878/socket"</code>
+
RewriteRule /(.*) ws://127.0.0.1:8686/$1 [P,L]
 +
 
 +
*<span id="fpcalc_upgrade">'''[[#fpcalc_upgrade|Fpcalc Needs Upgrading]]'''</span>
 +
Lidarr can use chromaprint audio fingerprinting to identify tracks. This depends on an external binary, which is distributed with Lidarr for Windows and macOS, but must be provided independently on Linux.
 +
 
 +
To fix this on a native Linux instance, install the appropriate package using your package manager and make sure that fpcalc is on your PATH (this can be checked using which fpcalc and verifying that the correct location of fpcalc is returned):
 +
 
 +
{| class="wikitable"
 +
|- style="font-weight:bold; text-align:center; vertical-align:middle;"
 +
! Distribution
 +
! Package
 +
|-
 +
| style="vertical-align:middle;" | Debian/Ubuntu
 +
| <code>libchromaprint-tools</code>
 +
|-
 +
| style="vertical-align:middle;" | Fedora/CentOS
 +
| <code>chromaprint-tools</code>
 +
|-
 +
| style="vertical-align:middle;" | Arch
 +
| <code>chromaprint</code>
 +
|-
 +
| style="vertical-align:middle;" | OpenSUSE
 +
|<code> chromaprint-fpcalc</code>
 +
|-
 +
| style="vertical-align:middle;" | Synology
 +
| <code>chromaprint</code>
 +
|}
 +
 
 +
*<span id="proxy_failed_resolve_ip">'''[[#proxy_failed_resolve_ip|Failed to resolve the IP Address for the Configured Proxy Host]]'''</span>
 +
** Review your proxy settings and ensure they are accurate
 +
** Ensure your proxy is up, running, and accessible
 +
 
 +
*<span id="proxy_failed_test">'''[[#proxy_failed_test|Proxy Failed Test]]'''</span>
 +
** Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
 +
 
 +
*<span id="system_time_off">'''[[#system_time_off|System Time is off by more than 1 day]]'''</span>
 +
** 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
 +
 
 +
*<span id="mediainfo_not_loaded">'''[[#mediainfo_not_loaded|MediaInfo Library Could not be Loaded]]'''</span>
 +
** MediaInfo Library could not be loaded.  
 +
 
 +
*<span id="mono_tls_legacy">'''[[#mono_tls_legacy|Mono Legacy TLS enabled]]'''</span>
 +
** Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option
 +
 
 
<section end=lidarr_system_status_health_system_warnings />
 
<section end=lidarr_system_status_health_system_warnings />
 +
 
===== Readarr =====
 
===== Readarr =====
 
<section begin=readarr_system_status_health_system_warnings />
 
<section begin=readarr_system_status_health_system_warnings />
 +
*<span id="branch_is_not_a_valid_release_branch">'''[[#branch_is_not_a_valid_release_branch|Branch is not a valid release branch]]'''</span>
 +
** 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.
 +
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
 
* <span id="update_to_net_core_version">'''[[#update_to_net_core_version|Update to .NET Core version]]'''</span>
** Newer versions of Readarr are targeted for .NET Core. We provide legacy mono builds for those platforms that cannot use .NET Core. You are running one of these legacy builds but your platform supports .NET Core.
+
** Newer versions of Readarr are targeted for .NET. We will soon no longer provide legacy mono builds for those platforms that cannot use .NET. You are running one of these legacy builds but your platform supports .NET Core.
 
** Fixing Docker installs
 
** Fixing Docker installs
 
*** Re-pull your container
 
*** Re-pull your container
 
** Fixing Standalone installs
 
** Fixing Standalone installs
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture:
 
****[https://readarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64 x64]
 
****[https://readarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm64 arm64]
 
****[https://readarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=arm arm]
 
 
***<span style="color:#ff0000">'''Back-Up your existing configuration'''</span> before the next step.
 
***<span style="color:#ff0000">'''Back-Up your existing configuration'''</span> before the next step.
*** '''Delete your existing binaries' (contents or folder of /opt/Readarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
+
*** This should only happen on Linux hosts.  <span style="color:#ff0000">'''Do not install .net core runtime or SDK from microsoft.'''</span> To remedy, download the correct build for your architecture. Please note that the links are for the <code>master</code> branch. If you are on <code>develop</code> or <code>nightly</code> you'll need to adjust <code>/master/</code> in the URL.
 +
***'''Delete your existing binaries (contents or folder of /opt/Readarr)''' and replace with the contents of the <code>.tar.gz</code> you just downloaded.
 
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''.</span>  
 
***<span style="color:#ff0000">'''DO NOT JUST EXTRACT THE DOWNLOAD OVER THE TOP OF YOUR EXISTING BINARIES.<br> YOU MUST DELETE THE OLD ONES FIRST'''.</span>  
**** Update your startup script to call <code>Readarr</code> instead of calling it with mono like <code>mono --debug Readarr.exe</code>. In other words you want, as an example, <code>/opt/Readarr/Readarr</code> and '''not''' <code>mono  --debug /opt/Readarr/Readarr</code>.
+
****<code>wget --content-disposition <nowiki>'http://readarr.servarr.com/v1/update/master/updatefile?os=linux&runtime=netcore&arch=x64'</nowiki></code> Download the .net binaries. The example is for a x64 (AMD64) installation.
*** If Readarr doesn’t start, ensure you have the dependencies listed [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux here] installed.
+
***** For most users, this would be <code>.linux-core-x64.tar.gz</code> selected via <code>arch=x64</code> in the url. For ARM use <code>arch=arm</code> and for ARM64 use <code>arch=arm64</code>
 +
****<code> sudo systemctl stop readarr</code> Stop Readarr
 +
****<code> sudo mv /opt/Readarr /opt/Readarr.old</code> Backup the old Binaries
 +
****<code> tar -xvzf Readarr*.linux-core-x64.tar.gz</code> Extract the Readarr Tarball
 +
****<code> sudo mv Readarr/ /opt</code> Move the new Readarr Binaries
 +
****<code> sudo chown -R readarr:readarr /opt/Readarr</code> Ensure Readarr has permissions to its directory, this assumes it runs as the user <code>readarr</code>
 +
****<code> sudo rm -rf /opt/Readarr.old</code> Remove the old binaries
 +
****<code> sudo rm -rf Readarr*.linux-core-x64.tar.gz</code> Remove the Tarball
 +
**** Update your startup script (<code> sudo nano -e /etc/systemd/system/readarr.service</code>) to call <code>Readarr</code> instead of calling it with mono like <code>mono --debug Readarr.exe</code>. In other words you want, as an example, <code>/opt/Readarr/Readarr</code> and '''not''' <code>mono  --debug /opt/Readarr/Readarr</code>.
 +
***** If Readarr doesn’t start, ensure you have [https://docs.microsoft.com/en-us/dotnet/core/install/dependencies?tabs=netcore31&pivots=os-linux the dependencies listed here] installed.
 +
****<code> systemctl daemon-reload</code> Reload the Systemd Files
 +
****<code> sudo systemctl start readarr.service</code> Restart Readarr
  
 
*<span id="mono_version_is_less_than_5_2_upgrade_for_improved_stability">'''[[#mono_version_is_less_than_5_2_upgrade_for_improved_stability|Mono version is less than 5.2, upgrade for improved stability]]'''</span>
 
*<span id="mono_version_is_less_than_5_2_upgrade_for_improved_stability">'''[[#mono_version_is_less_than_5_2_upgrade_for_improved_stability|Mono version is less than 5.2, upgrade for improved stability]]'''</span>
** Raedarr is written in .Net and requires Mono to run. Versions of 3.10 and above resolved various stability issues we experienced in the past and is considered the minimum supported version.<br />
+
** Readarr is written in .Net and requires Mono to run on very old ARM processors.  
** Mono version 5.x and higher are also available and provides a better experience on certain platforms.
+
** Mono 5.20 is the absolute minimum for Readarr.
 +
** The upgrade procedure for Mono varies per platform.
 
** See "Update to .NET Core version above"
 
** See "Update to .NET Core version above"
  
Line 203: Line 321:
 
*<span id="branch_is_for_a_previous_version">'''[[#branch_is_for_a_previous_version|Branch is for a previous version]]'''</span>
 
*<span id="branch_is_for_a_previous_version">'''[[#branch_is_for_a_previous_version|Branch is for a previous version]]'''</span>
 
** The update branch setup in Settings/General is for a previous version of Lidarr, therefore the instance will not see correct update information in the System/Updates feed and may not receive new updates when released.
 
** The update branch setup in Settings/General is for a previous version of Lidarr, therefore the instance will not see correct update information in the System/Updates feed and may not receive new updates when released.
**'''Note:''' Please note that v0.2 will only have critical bugs resolved as of August 2020. Any additional development or features will be solely in V3. Each push to the “develop” branch creates a build on “nightly” release channel (release channel is the “branch” within Lidarr’s settings), once we push a build to Github it will show up on “develop” release channel.
 
  
*<span id="could_not_connect_to_signalr">'''[[#could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
+
*<span id="Could_not_connect_to_signalr">'''[[#Could_not_connect_to_signalr|Could not connect to signalR]]'''</span>
 
** 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.
 
** 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 on V3 combined with an nginx reverse proxy. Nginx requires the following addition to the location block for Lidarr:
+
** The most common occurrence of this is use of a reverse proxy or cloudflare
*::<code>proxy_http_version 1.1;</code>
+
** Cloudflare needs websockets enabled.
*::<code>proxy_set_header Upgrade $http_upgrade;</code>
+
** Nginx requires the following addition to the location block for the app:
*::<code>proxy_set_header Connection $http_connection;</code>
+
  proxy_http_version 1.1;
 +
  proxy_set_header Upgrade $http_upgrade;
 +
  proxy_set_header Connection $http_connection;
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** Make sure you <span style="color:#ff0000">'''do not'''</span> include <code>proxy_set_header Connection "Upgrade";</code> as suggested by the nginx documentation. <span style="color:#ff0000">'''THIS WILL NOT WORK'''</span>
 
** See https://github.com/aspnet/AspNetCore/issues/17081
 
** See https://github.com/aspnet/AspNetCore/issues/17081
** For apache reverse proxy you need to add to the configuration:
+
** For Apache2 reverse proxy, you need to enable the following modules: <code>proxy</code>, <code>proxy_http</code>, and <code>proxy_wstunnel</code>. Then, add this websocket tunnel directive to your vhost configuration:
*::<code>Include /etc/apache2/mods-available/proxy_wstunnel.load</code>
+
RewriteEngine On
*::<code>ProxyPass "/socket" "ws://127.0.0.1:7878/socket"</code>
+
RewriteCond %{HTTP:Upgrade} =websocket [NC]
*::<code>ProxyPassReverse "/socket" "ws://127.0.0.1:7878/socket"</code>
+
RewriteRule /(.*) ws://127.0.0.1:8787/$1 [P,L]
 +
 
 +
*<span id="proxy_failed_resolve_ip">'''[[#proxy_failed_resolve_ip|Failed to resolve the IP Address for the Configured Proxy Host]]'''</span>
 +
** Review your proxy settings and ensure they are accurate
 +
** Ensure your proxy is up, running, and accessible
 +
 
 +
*<span id="proxy_failed_test">'''[[#proxy_failed_test|Proxy Failed Test]]'''</span>
 +
** Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
 +
 
 +
*<span id="proxy_">'''[[#system_time_off|System Time is off by more than 1 day]]'''</span>
 +
** 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
 +
 
 +
*<span id="mediainfo_not_loaded">'''[[#mediainfo_not_loaded|MediaInfo Library Could not be Loaded]]'''</span>
 +
** MediaInfo Library could not be loaded.  
 +
 
 +
*<span id="mono_tls_legacy">'''[[#mono_tls_legacy|Mono Legacy TLS enabled]]'''</span>
 +
** Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option
 +
 
 
<section end=readarr_system_status_health_system_warnings />
 
<section end=readarr_system_status_health_system_warnings />
 
  
 
==== Download Clients ====
 
==== Download Clients ====
Line 228: Line 364:
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
** 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.
 
** 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 improperlly configured download client. Things you can typically check:
+
** 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 machien this is typically <code>127.0.0.1</code>
+
*** Your download clients IP Address if its on the same bare metal machine this is typically <code>127.0.0.1</code>
 
*** 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.
 
*** 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 [[Radarr FAQ#Invalid Certificate and other HTTPS or SSL issues|here]] for more information on this one in our FAQ.
+
*** Ensure SSL encryption is not turned on if you're using both your Radarr instance and your download client on a local network. See [[Radarr FAQ#Invalid Certificate and other HTTPS or SSL issues|the SSL FAQ entry]] for more information.
  
* <span id="download_clients_are_unavailable_due_to_failure">'''[[#download_clients_are_unavailable_due_to_failure|Download clients are unavailable due to failure]]'''</span>
+
* <span id="download_clients_are_unavailable_due_to_failures">'''[[#download_clients_are_unavailable_due_to_failures|Download clients are unavailable due to failure]]'''</span>
 
** 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.
 
** 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-&gt;Logs to see what the reason is for the failures.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
Line 253: Line 389:
 
***** Radarr: <code>/data:/mnt/user/data</code>
 
***** Radarr: <code>/data:/mnt/user/data</code>
 
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/movies</code> and since you used <code>/data</code> in Radarr when the download client tells Radarr it's done Radarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/movies</code> all is right in the world."
 
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/movies</code> and since you used <code>/data</code> in Radarr when the download client tells Radarr it's done Radarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/movies</code> all is right in the world."
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/Misc/how-to-set-up-hardlinks-and-atomic-moves/ How To Set Up Hardlinks and Atomic-Moves] Now these guides place heavy emphasis on Hardlinks and Atomic moves (if you're using torrents you SERIOUSLY need to be using this) but the general concept of containers and how path mapping works is the core of these discussions.
+
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/hardlinks 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.
 +
 
 +
[https://trash-guides.info/Radarr/V3/Radarr-remote-path-mapping/ See TRaSH's Remote Path Guide for more information.]
 +
 
 +
* <span id="downloads_in_root_folder">'''[[#downloads_in_root_folder|Downloading into Root Folder]]'''</span>
 +
** 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 [[Radarr Settings#Root Folders|defined/configured root folders]] added not only root folders currently in use.
 +
 
 +
* <span id="bad_download_client_settings>'''[[#bad_download_client_settings|Bad Download Client Settings]]'''</span>
 +
** 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.
 +
 
 +
* <span id="bad_remote_path_mapping">'''[[#bad_remote_path_mapping|Bad Remote Path Mapping]]'''</span>
 +
** 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. [https://trash-guides.info/Radarr/V3/Radarr-remote-path-mapping/ See TRaSH's Remote Path Guide for more information.]
 +
 
 +
* <span id="permissions_error">'''[[#permissions_error|Permissions Error]]'''</span>
 +
** 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.
 +
 
 +
* <span id="remote_path_file_removed">'''[[#remote_path_file_removed|Remote File was removed part way through processing]]'''</span>
 +
** A file accessible via a remote path map appears to have been removed prior to processing completing.
 +
 
 +
* <span id="remote_path_import_failed">'''[[#remote_path_import_failed|Remote Path is Used and Import Failed]]'''</span>
 +
** Check your logs for more info; Refer to our Troubleshooting Guides
 
<section end=radarr_system_status_health_download_clients />
 
<section end=radarr_system_status_health_download_clients />
  
Line 263: Line 419:
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
** Sonarr 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.
 
** Sonarr 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 <code>127.0.0.1</code>
 +
*** 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 Sonarr.
 +
*** Ensure SSL encryption is not turned on if you're using both your Sonarr instance and your download client on a local network. See [[Sonarr FAQ#Invalid Certificate and other HTTPS or SSL issues|the SSL FAQ entry]] for more information.
  
* <span id="download_clients_are_unavailable_due_to_failure">'''[[#download_clients_are_unavailable_due_to_failure|Download clients are unavailable due to failure]]'''</span>
+
* <span id="download_clients_are_unavailable_due_to_failures">'''[[#download_clients_are_unavailable_due_to_failures|Download clients are unavailable due to failure]]'''</span>
 
** One or more of your download clients is not responding to requests made by Sonarr. Therefore Sonarr 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, Sonarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** One or more of your download clients is not responding to requests made by Sonarr. Therefore Sonarr 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, Sonarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
 
** If you no longer use this download client, disable it in Sonarr to prevent the errors.
 
** If you no longer use this download client, disable it in Sonarr to prevent the errors.
<section end=sonarr_system_status_health_download_clients />
+
 
 +
* <span id="downloads_in_root_folder">'''[[#downloads_in_root_folder|Downloading into Root Folder]]'''</span>
 +
** 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 [[Sonarr Settings#Root Folders|defined/configured root folders]] added not only root folders currently in use.
 +
 
 +
* <span id="bad_download_client_settings>'''[[#bad_download_client_settings|Bad Download Client Settings]]'''</span>
 +
** 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.
 +
 
 +
* <span id="bad_remote_path_mapping">'''[[#bad_remote_path_mapping|Bad Remote Path Mapping]]'''</span>
 +
** 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. [https://trash-guides.info/Sonarr/V3/Sonarr-remote-path-mapping/ See TRaSH's Remote Path Guide for more information.]
 +
 
 +
* <span id="permissions_error">'''[[#permissions_error|Permissions Error]]'''</span>
 +
** Sonarr or the user sonarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.
 +
 
 +
* <span id="remote_path_file_removed">'''[[#remote_path_file_removed|Remote File was removed part way through processing]]'''</span>
 +
** A file accessible via a remote path map appears to have been removed prior to processing completing.
 +
 
 +
* <span id="remote_path_import_failed">'''[[#remote_path_import_failed|Remote Path is Used and Import Failed]]'''</span>
 +
** Check your logs for more info; Refer to our Troubleshooting Guides
 +
<section end="sonarr_system_status_health_download_clients" />
  
 
===== Lidarr =====
 
===== Lidarr =====
Line 277: Line 455:
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
** Lidarr 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.
 
** Lidarr 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 improperlly configured download client. Things you can typically check:
+
** 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 machien this is typically <code>127.0.0.1</code>
+
*** Your download clients IP Address if its on the same bare metal machine this is typically <code>127.0.0.1</code>
 
*** 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 Lidarr.
 
*** 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 Lidarr.
*** Ensure SSL encryption is not turned on if you're using both your Lidarr instance and your download client on a local network. See [[Lidarr FAQ#Invalid Certificate and other HTTPS or SSL issues|here]] for more information on this one in our FAQ.
+
*** Ensure SSL encryption is not turned on if you're using both your Lidarr instance and your download client on a local network. See [[Lidarr FAQ#Invalid Certificate and other HTTPS or SSL issues|the SSL FAQ entry]] for more information.
  
* <span id="download_clients_are_unavailable_due_to_failure">'''[[#download_clients_are_unavailable_due_to_failure|Download clients are unavailable due to failure]]'''</span>
+
* <span id="download_clients_are_unavailable_due_to_failures">'''[[#download_clients_are_unavailable_due_to_failures|Download clients are unavailable due to failure]]'''</span>
 
** One or more of your download clients is not responding to requests made by Lidarr. Therefore Lidarr 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, Lidarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** One or more of your download clients is not responding to requests made by Lidarr. Therefore Lidarr 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, Lidarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
Line 296: Line 474:
 
**** Download client: <code>Download Path: /downloads:/mnt/user/downloads</code>
 
**** Download client: <code>Download Path: /downloads:/mnt/user/downloads</code>
 
**** Lidarr: <code>Download Path: /data:/mnt/user/downloads</code>
 
**** Lidarr: <code>Download Path: /data:/mnt/user/downloads</code>
**** Within this example the download client places its downloads into <code>/downloads</code> and therefore tells Lidarr when its complete that the finished movie is in <code>/downloads</code>. Lidarr then comes along and says "Okay, cool, let me check in <code>/downloads</code>" Well, inside Lidarr you did not allocate a <code>/downloads</code> path you allocated a <code>/data</code> path so it throws this error.
+
**** Within this example the download client places its downloads into <code>/downloads</code> and therefore tells Lidarr when its complete that the finished song is in <code>/downloads</code>. Lidarr then comes along and says "Okay, cool, let me check in <code>/downloads</code>" Well, inside Lidarr you did not allocate a <code>/downloads</code> path you allocated a <code>/data</code> 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.
 
**** The easiest fix for this is  '''CONSISTENCY''' if you use one scheme in your download client, use it across the board.
 
**** Team Lidarr is a big fan of simply using <code>/data</code>.
 
**** Team Lidarr is a big fan of simply using <code>/data</code>.
 
***** Download client: <code>/data:/mnt/user/data</code>
 
***** Download client: <code>/data:/mnt/user/data</code>
 
***** Lidarr: <code>/data:/mnt/user/data</code>
 
***** Lidarr: <code>/data:/mnt/user/data</code>
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/movies</code> and since you used <code>/data</code> in Lidarr when the download client tells Lidarr it's done Lidarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/movies</code> all is right in the world."
+
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/audio</code> and since you used <code>/data</code> in Lidarr when the download client tells Lidarr it's done Lidarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/audio</code> all is right in the world."
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/Misc/how-to-set-up-hardlinks-and-atomic-moves/ How To Set Up Hardlinks and Atomic-Moves] Now these guides place heavy emphasis on Hardlinks and Atomic moves (if you're using torrents you SERIOUSLY need to be using this) but the general concept of containers and how path mapping works is the core of these discussions.
+
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/Misc/how-to-set-up-hardlinks-and-atomic-moves/ 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.
 +
 
 +
* <span id="downloads_in_root_folder">'''[[#downloads_in_root_folder|Downloading into Root Folder]]'''</span>
 +
** 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 [[Lidarr Settings#Root Folders|defined/configured root folders]] added not only root folders currently in use.
 +
 
 +
* <span id="bad_download_client_settings>'''[[#bad_download_client_settings|Bad Download Client Settings]]'''</span>
 +
** 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.
 +
 
 +
* <span id="bad_remote_path_mapping">'''[[#bad_remote_path_mapping|Bad Remote Path Mapping]]'''</span>
 +
** 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. [https://trash-guides.info/Radarr/V3/Radarr-remote-path-mapping/ See TRaSH's Remote Path Guide for more information. The link is for Radarr, but the same concept applies.]
 +
 
 +
* <span id="permissions_error">'''[[#permissions_error|Permissions Error]]'''</span>
 +
** Lidarr or the user lidarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.
 +
 
 +
* <span id="remote_path_file_removed">'''[[#remote_path_file_removed|Remote File was removed part way through processing]]'''</span>
 +
** A file accessible via a remote path map appears to have been removed prior to processing completing.
 +
 
 +
* <span id="remote_path_import_failed">'''[[#remote_path_import_failed|Remote Path is Used and Import Failed]]'''</span>
 +
** Check your logs for more info; Refer to our Troubleshooting Guides
 +
 
 
<section end=lidarr_system_status_health_download_clients />
 
<section end=lidarr_system_status_health_download_clients />
 
===== Readarr =====
 
===== Readarr =====
Line 311: Line 508:
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
* <span id="unable_to_communicate_with_download_client">'''[[#unable_to_communicate_with_download_client|Unable to communicate with download client]]'''</span>
 
** Readarr 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.
 
** Readarr 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 improperlly configured download client. Things you can typically check:
+
** 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 machien this is typically <code>127.0.0.1</code>
+
*** Your download clients IP Address if its on the same bare metal machine this is typically <code>127.0.0.1</code>
 
*** 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 Readarr.
 
*** 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 Readarr.
*** Ensure SSL encryption is not turned on if you're using both your Readarr instance and your download client on a local network. See [[Readarr FAQ#Invalid Certificate and other HTTPS or SSL issues|here]] for more information on this one in our FAQ.
+
*** Ensure SSL encryption is not turned on if you're using both your Readarr instance and your download client on a local network. See [[Readarr FAQ#Invalid Certificate and other HTTPS or SSL issues|the SSL FAQ entry]] for more information.
  
* <span id="download_clients_are_unavailable_due_to_failure">'''[[#download_clients_are_unavailable_due_to_failure|Download clients are unavailable due to failure]]'''</span>
+
* <span id="download_clients_are_unavailable_due_to_failures">'''[[#download_clients_are_unavailable_due_to_failures|Download clients are unavailable due to failure]]'''</span>
 
** One or more of your download clients is not responding to requests made by Readarr. Therefore Readarr 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, Readarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** One or more of your download clients is not responding to requests made by Readarr. Therefore Readarr 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, Readarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
 
** You should inspect System-&gt;Logs to see what the reason is for the failures.
Line 330: Line 527:
 
**** Download client: <code>Download Path: /downloads:/mnt/user/downloads</code>
 
**** Download client: <code>Download Path: /downloads:/mnt/user/downloads</code>
 
**** Readarr: <code>Download Path: /data:/mnt/user/downloads</code>
 
**** Readarr: <code>Download Path: /data:/mnt/user/downloads</code>
**** Within this example the download client places its downloads into <code>/downloads</code> and therefore tells Radarr when its complete that the finished movie is in <code>/downloads</code>. Readarr then comes along and says "Okay, cool, let me check in <code>/downloads</code>" Well, inside Readarr you did not allocate a <code>/downloads</code> path you allocated a <code>/data</code> path so it throws this error.
+
**** Within this example the download client places its downloads into <code>/downloads</code> and therefore tells Radarr when its complete that the finished book is in <code>/downloads</code>. Readarr then comes along and says "Okay, cool, let me check in <code>/downloads</code>" Well, inside Readarr you did not allocate a <code>/downloads</code> path you allocated a <code>/data</code> 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.
 
**** The easiest fix for this is  '''CONSISTENCY''' if you use one scheme in your download client, use it across the board.
 
**** Team Readarr is a big fan of simply using <code>/data</code>.
 
**** Team Readarr is a big fan of simply using <code>/data</code>.
 
***** Download client: <code>/data:/mnt/user/data</code>
 
***** Download client: <code>/data:/mnt/user/data</code>
 
***** Readarr: <code>/data:/mnt/user/data</code>
 
***** Readarr: <code>/data:/mnt/user/data</code>
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/movies</code> and since you used <code>/data</code> in Readarr when the download client tells Readarr it's done Readarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/movies</code> all is right in the world."
+
***** Now within the download client you can specify where in <code>/data</code> 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." <code>/data/torrents (or usenet)/books</code> and since you used <code>/data</code> in Readarr when the download client tells Readarr it's done Readarr will come along and say "Sweet, I have a <code>/data</code> and I also can see <code>/torrents (or usenet)/books</code> all is right in the world."
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/Misc/how-to-set-up-hardlinks-and-atomic-moves/ How To Set Up Hardlinks and Atomic-Moves] Now these guides place heavy emphasis on Hardlinks and Atomic moves (if you're using torrents you SERIOUSLY need to be using this) but the general concept of containers and how path mapping works is the core of these discussions.
+
*** There are many great write ups by some very talented people one on our wiki [[Docker Guide]] and the other by TRaSH with his [https://trash-guides.info/Misc/how-to-set-up-hardlinks-and-atomic-moves/ 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.
 +
 
 +
* <span id="downloads_in_root_folder">'''[[#downloads_in_root_folder|Downloading into Root Folder]]'''</span>
 +
** 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 [[Readarr Settings#Root Folders|defined/configured root folders]] added not only root folders currently in use.
 +
 
 +
* <span id="bad_download_client_settings>'''[[#bad_download_client_settings|Bad Download Client Settings]]'''</span>
 +
** 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.
 +
 
 +
* <span id="bad_remote_path_mapping">'''[[#bad_remote_path_mapping|Bad Remote Path Mapping]]'''</span>
 +
** 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. [https://trash-guides.info/Radarr/V3/Radarr-remote-path-mapping/ See TRaSH's Remote Path Guide for more information. The link is for Radarr, but the same concept applies.]
 +
 
 +
* <span id="permissions_error">'''[[#permissions_error|Permissions Error]]'''</span>
 +
** Readarr or the user readarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.
 +
 
 +
* <span id="remote_path_file_removed">'''[[#remote_path_file_removed|Remote File was removed part way through processing]]'''</span>
 +
** A file accessible via a remote path map appears to have been removed prior to processing completing.
 +
 
 +
* <span id="remote_path_import_failed">'''[[#remote_path_import_failed|Remote Path is Used and Import Failed]]'''</span>
 +
** Check your logs for more info; Refer to our Troubleshooting Guides
 +
 
 
<section end=readarr_system_status_health_download_clients />
 
<section end=readarr_system_status_health_download_clients />
  
Line 343: Line 559:
 
<section begin=radarr_system_status_health_complete_failed_download_handling />
 
<section begin=radarr_system_status_health_complete_failed_download_handling />
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
** ''(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.)''
+
**''(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 switch to 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.
+
** 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. * If you added a post-processing script to Sabnzbd/NzbGet to notify Radarr that it should scan the Drone Factory. You ''SHOULD'' disable this script to prevent conflicts. * Completed Download Handling and the Drone Factory cannot be configured for the same directory. If Completed Download Handling detects a download resides in the Drone Factory it will be ignored. (again to prevent conflicts)<br />
+
** 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.
** You should reconfigure Radarr to use a different Drone Factory Folder or disable it altogether.<br />
 
** Alternatively you can change the output folder for the Category, as long as that output folder is not a subdirectory of the Drone Factory Folder.
 
** Both Completed Download Handling and the Drone Factory logic generates Import Events in history while importing files. However, only Completed Download Handling associates this Import event with a Download Client history item. If Completed Download Handling was enabled recently, your download client may still contain history items that were already imported but do not have a history event with the same unique id. Radarr attempts to resolve this issue automatically, occassionally Radarr may be unable to make that association and cause a ‘Completed’ download to be listed in the History -&gt; Queue table forever. The easiest way to resolve this is to clear your Download Client history, or only those individual items. Alternatively you can rename the category.
 
 
<section end=radarr_system_status_health_complete_failed_download_handling />
 
<section end=radarr_system_status_health_complete_failed_download_handling />
  
Line 355: Line 568:
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
 
**''(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.)''
 
**''(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 switch to Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients. With it, Sonarr will only import a download once the download client reports it as ready.
+
** 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, Sonarr 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:
+
** 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 Sonarr are on the same machine since it gets the path to be imported directly from the  
*** '''Warning''': Completed Download Handling only works properly if the download client and Sonarr are on the same machine since it gets the path to be imported directly from the download client.
 
*** If you added a post-processing script to Sabnzbd/NzbGet to notify Sonarr that it should scan the Drone Factory. You ''SHOULD'' disable this script to prevent conflicts.
 
*** Completed Download Handling and the Drone Factory cannot be configured for the same directory. If Completed Download Handling detects a download resides in the Drone Factory it will be ignored. (again to prevent conflicts)<br />
 
Alternatively you can change the output folder for the Category, as long as that output folder is not a subdirectory of the Drone Factory Folder.
 
** Both Completed Download Handling and the Drone Factory logic generates Import Events in history while importing files. However, only Completed Download Handling associates this Import event with a Download Client history item. If Completed Download Handling was enabled recently, your download client may still contain history items that were already imported but do not have a history event with the same unique id. Sonarr attempts to resolve this issue automatically, occassionally Sonarr may be unable to make that association and cause a 'Completed' download to be listed in the History -&gt; Queue table forever. The easiest way to resolve this is to clear your Download Client history, or only those individual items. Alternatively you can rename the category.
 
 
<section end=sonarr_system_status_health_complete_failed_download_handling />
 
<section end=sonarr_system_status_health_complete_failed_download_handling />
  
Line 367: Line 575:
 
<section begin=lidarr_system_status_health_complete_failed_download_handling />
 
<section begin=lidarr_system_status_health_complete_failed_download_handling />
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
** ''(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.)''
+
**''(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 switch to Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients. With it, Lidarr will only import a download once the download client reports it as ready.
+
** 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, Lidarr 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 Lidarr are on the same machine since it gets the path to be imported directly from the download client. * If you added a post-processing script to Sabnzbd/NzbGet to notify Lidarr that it should scan the Drone Factory. You ''SHOULD'' disable this script to prevent conflicts. * Completed Download Handling and the Drone Factory cannot be configured for the same directory. If Completed Download Handling detects a download resides in the Drone Factory it will be ignored. (again to prevent conflicts)<br />
+
** 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 Lidrr are on the same machine since it gets the path to be imported directly from the download client otherwise a remote map is needed.
** You should reconfigure Lidarr to use a different Drone Factory Folder or disable it altogether.<br />
 
** Alternatively you can change the output folder for the Category, as long as that output folder is not a subdirectory of the Drone Factory Folder.
 
** Both Completed Download Handling and the Drone Factory logic generates Import Events in history while importing files. However, only Completed Download Handling associates this Import event with a Download Client history item. If Completed Download Handling was enabled recently, your download client may still contain history items that were already imported but do not have a history event with the same unique id. Lidarr attempts to resolve this issue automatically, occassionally Lidarr may be unable to make that association and cause a ‘Completed’ download to be listed in the History -&gt; Queue table forever. The easiest way to resolve this is to clear your Download Client history, or only those individual items. Alternatively you can rename the category.
 
 
<section end=lidarr_system_status_health_complete_failed_download_handling />
 
<section end=lidarr_system_status_health_complete_failed_download_handling />
  
Line 378: Line 583:
 
<section begin=readarr_system_status_health_complete_failed_download_handling />
 
<section begin=readarr_system_status_health_complete_failed_download_handling />
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
 
* <span id="completed_download_handling_is_disabled">'''[[#completed_download_handling_is_disabled|Completed Download Handling is disabled]]'''</span>
** ''(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.)''
+
**''(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 switch to Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients. With it, Readarr will only import a download once the download client reports it as ready.
+
** 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, Readarr 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 Readarr are on the same machine since it gets the path to be imported directly from the download client. * If you added a post-processing script to Sabnzbd/NzbGet to notify Readarr that it should scan the Drone Factory. You ''SHOULD'' disable this script to prevent conflicts. * Completed Download Handling and the Drone Factory cannot be configured for the same directory. If Completed Download Handling detects a download resides in the Drone Factory it will be ignored. (again to prevent conflicts)<br />
+
** 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 Readarr are on the same machine since it gets the path to be imported directly from the download client otherwise a remote map is needed.
** You should reconfigure Readarr to use a different Drone Factory Folder or disable it altogether.<br />
 
** Alternatively you can change the output folder for the Category, as long as that output folder is not a subdirectory of the Drone Factory Folder.
 
** Both Completed Download Handling and the Drone Factory logic generates Import Events in history while importing files. However, only Completed Download Handling associates this Import event with a Download Client history item. If Completed Download Handling was enabled recently, your download client may still contain history items that were already imported but do not have a history event with the same unique id. Readarr attempts to resolve this issue automatically, occassionally Readarr may be unable to make that association and cause a ‘Completed’ download to be listed in the History -&gt; Queue table forever. The easiest way to resolve this is to clear your Download Client history, or only those individual items. Alternatively you can rename the category.
 
 
<section end=readarr_system_status_health_complete_failed_download_handling />
 
<section end=readarr_system_status_health_complete_failed_download_handling />
  
Line 389: Line 591:
 
===== Radarr =====
 
===== Radarr =====
 
<section begin=radarr_system_status_health_indexers />
 
<section begin=radarr_system_status_health_indexers />
 +
* <span id="no_indexers_available_with_automatic_search_enabled_radarr_will_not_provide_any_automatic_search_results">'''[[#no_indexers_available_with_automatic_search_enabled_radarr_will_not_provide_any_automatic_search_results|No indexers available with automatic search enabled, Radarr will not provide any automatic search results]]'''</span>
 +
** 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.
 +
*<span id="no_indexers_available_with_rss_sync_enabled_radarr_will_not_grab_new_releases_automatically">'''[[#no_indexers_available_with_rss_sync_enabled_radarr_will_not_grab_new_releases_automatically|No indexers available with RSS sync enabled, Radarr will not grab new releases automatically]]'''</span>
 +
** So Radarr uses the RSS feed to pick up new releases as they come along. More info on that [[Radarr FAQ#How does Radarr work?|here]]
 +
** To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
** Radarr requires indexers to be able to discover new releases. [[Radarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
** Radarr requires indexers to be able to discover new releases. [[Radarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
 
** 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.
 
** 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.
 +
* <span id="no_indexers_available_with_interactive_search_enabled">'''[[#no_indexers_available_with_interactive_search_enabled|No indexers avaiable with Interactive Search Enabled"]]''' </span>
 +
** 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.
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
** 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).
 
** 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).
Line 402: Line 612:
 
===== Sonarr =====
 
===== Sonarr =====
 
<section begin=sonarr_system_status_health_indexers />
 
<section begin=sonarr_system_status_health_indexers />
 +
* <span id="no_indexers_available_with_automatic_search_enabled_sonarr_will_not_provide_any_automatic_search_results">'''[[#no_indexers_available_with_automatic_search_enabled_sonarr_will_not_provide_any_automatic_search_results|No indexers available with automatic search enabled, Sonarr will not provide any automatic search results]]'''</span>
 +
** 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.
 +
*<span id="no_indexers_available_with_rss_sync_enabled_sonarr_will_not_grab_new_releases_automatically">'''[[#no_indexers_available_with_rss_sync_enabled_sonarr_will_not_grab_new_releases_automatically|No indexers available with RSS sync enabled, Sonarr will not grab new releases automatically]]'''</span>
 +
** So Sonarr uses the RSS feed to pick up new releases as they come along. More info on that [[Sonarr FAQ#How does Sonarr work?|here]]
 +
** To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
** Sonarr requires indexers to be able to discover new releases. [[Sonarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
** Sonarr requires indexers to be able to discover new releases. [[Sonarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]'''</span>
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]'''</span>
 
** None of the indexers you have enabled support searching. This means Sonarr will only be able to find new releases via the RSS feeds. But searching for episodes (either Automatic Search or Manual Search) will never return any results. Obviously, the only way to remedy it is to add another indexer.
 
** None of the indexers you have enabled support searching. This means Sonarr will only be able to find new releases via the RSS feeds. But searching for episodes (either Automatic Search or Manual Search) will never return any results. Obviously, the only way to remedy it is to add another indexer.
 +
* <span id="no_indexers_available_with_interactive_search_enabled">'''[[#no_indexers_available_with_interactive_search_enabled|No indexers avaiable with Interactive Search Enabled"]]''' </span>
 +
** 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.
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
** Errors occurs while Sonarr tried to use one of your indexers. To limit retries, Sonarr will not use the indexer for an increasing amount of time (up to 24h).<br />
+
** Errors occurs while Sonarr tried to use one of your indexers. To limit retries, Sonarr will not use the indexer for an increasing amount of time (up to 24h).
 
** This mechanism is triggered if Sonarr 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.
 
** This mechanism is triggered if Sonarr 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.
 
** You can prevent the warning by disabling the affected indexer.
**Run the Test on the indexer to force Sonarr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.
+
** Run the Test on the indexer to force Sonarr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.
 
<section end=sonarr_system_status_health_indexers />
 
<section end=sonarr_system_status_health_indexers />
 
===== Lidarr =====
 
===== Lidarr =====
Line 417: Line 635:
 
** Simply put you do not have any of your indexers set to allow automatic searches
 
** 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.
 
*** Go into Settings > Indexers, select an indexer you'd like to allow Automatic Searches and then click save.
 
+
*<span id="no_indexers_available_with_rss_sync_enabled_lidarr_will_not_grab_new_releases_automatically">'''[[#no_indexers_available_with_rss_sync_enabled_lidarr_will_not_grab_new_releases_automatically|No indexers available with RSS sync enabled, Lidarr will not grab new releases automatically]]'''</span>
*<span id="no_indexers_available_with_rss_sync_enabled_lidarr_will_not_grab_new_releases_automatically">'''[[#no_indexers_available_with_rss_sync_enabled_lidarr_will_not_grab_new_releases_automatically|No indexers avaiable with RSS syn enabled, Lidarr will not grab new releases automatically]]'''</span>
 
 
** So Lidarr uses the RSS feed to pick up new releases as they come along. More info on that [[Lidarr FAQ#How does Lidarr work?|here]]
 
** So Lidarr uses the RSS feed to pick up new releases as they come along. More info on that [[Lidarr FAQ#How does Lidarr work?|here]]
 
** To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
 
** To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
 
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
** Lidarr requires indexers to be able to discover new releases. [[Lidarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
** Lidarr requires indexers to be able to discover new releases. [[Lidarr_Settings#Indexers|Please read the wiki on instructions how to add indexers]].
 
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
** None of the indexers you have enabled support searching. This means Lidarr 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.
+
** None of the indexers you have enabled support searching. This means Lidarr will only be able to find new releases via the RSS feeds. But searching for music (either Automatic Search or Manual Search) will never return any results. Obviously, the only way to remedy it is to add another indexer.
 
+
* <span id="no_indexers_available_with_interactive_search_enabled">'''[[#no_indexers_available_with_interactive_search_enabled|No indexers avaiable with Interactive Search Enabled"]]''' </span>
 +
** 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.
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
** Errors occurs while Lidarr tried to use one of your indexers. To limit retries, Lidarr will not use the indexer for an increasing amount of time (up to 24h).
 
** Errors occurs while Lidarr tried to use one of your indexers. To limit retries, Lidarr will not use the indexer for an increasing amount of time (up to 24h).
Line 436: Line 652:
 
===== Readarr =====
 
===== Readarr =====
 
<section begin=readarr_system_status_health_indexers />
 
<section begin=readarr_system_status_health_indexers />
 +
* <span id="no_indexers_available_with_automatic_search_enabled_readarr_will_not_provide_any_automatic_search_results">'''[[#no_indexers_available_with_automatic_search_enabled_readarr_will_not_provide_any_automatic_search_results|No indexers available with automatic search enabled, Readarr will not provide any automatic search results]]'''</span>
 +
** 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.
 +
*<span id="no_indexers_available_with_rss_sync_enabled_readarr_will_not_grab_new_releases_automatically">'''[[#no_indexers_available_with_rss_sync_enabled_readarr_will_not_grab_new_releases_automatically|No indexers available with RSS sync enabled, Readarr will not grab new releases automatically]]'''</span>
 +
** So Readarr uses the RSS feed to pick up new releases as they come along. More info on that [[Readarr FAQ#How does Readarr work?|here]]
 +
** To correct this issue go to Settings > Indexers, select an indexer you have and enable RSS Sync
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
* <span id="no_indexers_are_enabled">'''[[#no_indexers_are_enabled|No indexers are enabled]]'''</span>
 
** Readarr requires indexers to be able to discover new releases. [[Readarr_Settings#Indexers|Please read the wiki on instructions how to add indexers.]]
 
** Readarr requires indexers to be able to discover new releases. [[Readarr_Settings#Indexers|Please read the wiki on instructions how to add indexers.]]
 
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
 
* <span id="enabled_indexers_do_not_support_searching">'''[[#enabled_indexers_do_not_support_searching|Enabled indexers do not support searching]]''' </span>
** None of the indexers you have enabled support searching. This means Readarr 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.
+
** None of the indexers you have enabled support searching. This means Readarr will only be able to find new releases via the RSS feeds. But searching for books (either Automatic Search or Manual Search) will never return any results. Obviously, the only way to remedy it is to add another indexer.
 
+
* <span id="no_indexers_available_with_interactive_search_enabled">'''[[#no_indexers_available_with_interactive_search_enabled|No indexers avaiable with Interactive Search Enabled"]]''' </span>
 +
** 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.
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
* <span id="indexers_are_unavailable_due_to_failures">'''[[#indexers_are_unavailable_due_to_failures|Indexers are unavailable due to failures]]'''</span>
 
** Errors occurs while Readarr tried to use one of your indexers. To limit retries, Readarr will not use the indexer for an increasing amount of time (up to 24h).
 
** Errors occurs while Readarr tried to use one of your indexers. To limit retries, Readarr will not use the indexer for an increasing amount of time (up to 24h).
Line 458: Line 680:
 
***# Create a custom filter with the old root folder path
 
***# 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.
 
***# 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 recieve 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
+
***# 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
 
<section end=radarr_system_status_health_folders />
 
<section end=radarr_system_status_health_folders />
 
===== Sonarr =====
 
===== Sonarr =====
Line 467: Line 689:
 
***# Go to the Series > Mass Editor Tab
 
***# Go to the Series > Mass Editor Tab
 
***# Create a custom filter with the old root folder path  
 
***# Create a custom filter with the old root folder path  
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these movies to be moved to.
+
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these series to be moved to.
***# Next you'll recieve a pop-up that states '''Would you like to move the series folders to '<root path>'?''' Simply select No if the you do not want Sonarr to move your files
+
***# Next you'll receive a pop-up that states '''Would you like to move the series folders to '<root path>'?''' Simply select No if the you do not want Sonarr to move your files
 +
* <span id="import_list_missing_root_folder">'''[[#import_list_missing_root_folder|Import List missing root folder]]'''</span>
 +
** This error is typically identified if a list is looking for a root folder but that root folder is no longer available.
 +
**#Go to Settings > Import Lists
 +
**#Edit the import lists that were mentioned in the health check
 +
**#Save
 
<section end=sonarr_system_status_health_folders />
 
<section end=sonarr_system_status_health_folders />
 
===== Lidarr =====
 
===== Lidarr =====
Line 477: Line 704:
 
***# Go to the Library > Mass Editor Tab
 
***# Go to the Library > Mass Editor Tab
 
***# Create a custom filter with the old root folder path  
 
***# Create a custom filter with the old root folder path  
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these movies to be moved to.
+
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these artists to be moved to.
***# Next you'll recieve a pop-up that states '''Would you like to move the artist folders to '<root path>'?''' Simply select No if the you do not want Lidarr to move your files
+
***# Next you'll receive a pop-up that states '''Would you like to move the artist folders to '<root path>'?''' Simply select No if the you do not want Lidarr to move your files
 
<section end=lidarr_system_status_health_folders />
 
<section end=lidarr_system_status_health_folders />
 
===== Readarr =====
 
===== Readarr =====
Line 487: Line 714:
 
***# Go to the Library > Mass Editor Tab
 
***# Go to the Library > Mass Editor Tab
 
***# Create a custom filter with the old root folder path  
 
***# Create a custom filter with the old root folder path  
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these movies to be moved to.
+
***# Once the series have been found find the  '''Root Paths''' drop down and select the new root path that you want these authors to be moved to.
***# Next you'll recieve a pop-up that states '''Would you like to move the author folders to '<root path>'?''' Simply select No if the you do not want Readarr to move your files
+
***# Next you'll receive a pop-up that states '''Would you like to move the author folders to '<root path>'?''' Simply select No if the you do not want Readarr to move your files
 
<section end=readarr_system_status_health_folders />
 
<section end=readarr_system_status_health_folders />
  
Line 495: Line 722:
 
<section begin=radarr_system_status_health_media />
 
<section begin=radarr_system_status_health_media />
 
* <span id="movie_was_removed_from_tmdb">'''[[#movie_was_removed_from_tmdb|Movie was removed from TMDb]]'''</span>
 
* <span id="movie_was_removed_from_tmdb">'''[[#movie_was_removed_from_tmdb|Movie was removed from TMDb]]'''</span>
** The movie is linked to a TMDbId 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.<br />
+
** 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.<br />
 
** 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
 
** 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
  
Line 519: Line 746:
 
<section begin=radarr_system_status_disk_space />
 
<section begin=radarr_system_status_disk_space />
 
* This section will show you available 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 w/in your Docker image
+
** In docker this can be tricky as it will typically show you the available space within your Docker image
 
<section end=radarr_system_status_disk_space />
 
<section end=radarr_system_status_disk_space />
 
==== Sonarr ====
 
==== Sonarr ====
 
<section begin=sonarr_system_status_disk_space />
 
<section begin=sonarr_system_status_disk_space />
 
* This section will show you available 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 w/in your Docker image
+
** In docker this can be tricky as it will typically show you the available space within your Docker image
 
<section end=sonarr_system_status_disk_space />
 
<section end=sonarr_system_status_disk_space />
 
==== Lidarr ====
 
==== Lidarr ====
 
<section begin=lidarr_system_status_disk_space />
 
<section begin=lidarr_system_status_disk_space />
 
* This section will show you available 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 w/in your Docker image
+
** In docker this can be tricky as it will typically show you the available space within your Docker image
 
<section end=lidarr_system_status_disk_space />
 
<section end=lidarr_system_status_disk_space />
 
==== Readarr ====
 
==== Readarr ====
 
<section begin=readarr_system_status_disk_space />
 
<section begin=readarr_system_status_disk_space />
 
* This section will show you available 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 w/in your Docker image
+
** In docker this can be tricky as it will typically show you the available space within your Docker image
 
<section end=readarr_system_status_disk_space />
 
<section end=readarr_system_status_disk_space />
  
Line 542: Line 769:
 
This will tell you about your current install of Radarr
 
This will tell you about your current install of Radarr
 
<section end=radarr_system_status_about />
 
<section end=radarr_system_status_about />
 
 
==== Sonarr ====
 
==== Sonarr ====
 
<section begin=sonarr_system_status_about />
 
<section begin=sonarr_system_status_about />
Line 559: Line 785:
 
==== Radarr ====
 
==== Radarr ====
 
<section begin=radarr_system_status_more_info />
 
<section begin=radarr_system_status_more_info />
* Home page: [https://radarr.video Radarr's home page]
+
* Home Page: [https://radarr.video Radarr's home page]
* Discord: [https://discord.gg/r5wJPt9 Join our discord]
+
* Wiki: [https://wiki.servarr.com/Radarr You're here already]
* Reddit: [htttps://reddit.com/r/radarr]
+
* Reddit: [https://reddit.com/r/radarr r/radarr]
* Wiki: [https://wiki.servarr.com You're here already]
+
* Discord: [https://radarr.video/discord Join our discord]
* Donations: If you're feeling generous and would like to donate click [https://opencollective.com/radarr here]
+
* Donations: If you're feeling generous and would like to donate [https://opencollective.com/radarr click here]
 +
* Donations to Sonarr: If you're feeling generous and would like to donate to the project that started it all [https://sonarr.tv/donate  click here]
 
* Source: [https://github.com/Radarr/Radarr Github]
 
* Source: [https://github.com/Radarr/Radarr Github]
* Feature Requests: Got as great idea drop it [https://github.com/Radarr/Radarr/issues here]
+
* Feature Requests: Got a great idea drop it [https://github.com/Radarr/Radarr/issues here]
 
<section end=radarr_system_status_more_info />
 
<section end=radarr_system_status_more_info />
 
 
==== Sonarr ====
 
==== Sonarr ====
 
<section begin=sonarr_system_status_more_info />
 
<section begin=sonarr_system_status_more_info />
* Home page: [https://radarr.video Radarr's home page]
+
* Home page: [https://sonarr.tv Sonarr's home page]
* Forums: [forums.sonarr.tv Official Sonarr Forums]
+
* Forums: [https://forums.sonarr.tv Sonarr Forums]
* Discord: [discord.gg/M6BvZn5 Join our discord]
+
* Discord: [https://discord.gg/M6BvZn5 Join our discord]
* Reddit: [https://reddit.com/r/sonarr]
+
* Reddit: [https://reddit.com/r/sonarr r/sonarr]
* Twitter: [@sonarrtv]
+
* Twitter: [https://twitter.com/sonarrtv @sonarrtv]
 
* IRC: [https://webchat.freenode.net/?channels=#sonarr #sonarr on Freenode]
 
* IRC: [https://webchat.freenode.net/?channels=#sonarr #sonarr on Freenode]
* Wiki: [https://wiki.servarr.com You're here already]
+
* Wiki: [https://wiki.servarr.com/sonarr You're here already]
* Donations: If you're feeling generous and would like to donate click [https://sonarr.tv/donate here]
+
* Donations: If you're feeling generous and would like to donate [https://sonarr.tv/donate click here]
* Source: [github.com/Sonarr/Sonarr Github]
+
* Source: https://github.com/Sonarr/Sonarr Github]
* Feature Requests: Got as great idea drop it on Github [github.com/Sonarr/Sonarr/issuess here] or the Forums [forums.sonarr.tv here]
+
* Feature Requests: Got a great idea drop it on Github [https://github.com/Sonarr/Sonarr/issues here]
 
<section end=sonarr_system_status_more_info />
 
<section end=sonarr_system_status_more_info />
 
==== Lidarr ====
 
==== Lidarr ====
 
<section begin=lidarr_system_status_more_info />
 
<section begin=lidarr_system_status_more_info />
* Home page: [lidarr.audio Lidarr's home page]
+
* Home page: [https://lidarr.audio Lidarr's home page]
* Discord: [https://discord.com/invite/5WQc3S8 Join our discord]
+
* Wiki: [https://wiki.servarr.com/Lidarr You're here already]
* Reddit: [https://reddit.com/r/lidarr Lidarr's SubReddit]
+
* Reddit: [https://reddit.com/r/lidarr r/lidarr]
* Wiki: [https://wiki.servarr.com You're here already]
+
* Discord: [https://lidarr.audio/discord Join our discord]
* Donations: If you're feeling generous and would like to donate click [https://opencollective.com/lidarr here]
+
* Donations: If you're feeling generous and would like to donate [https://opencollective.com/lidarr click here]
 +
* Donations to Sonarr: If you're feeling generous and would like to donate to the project that started it all [https://sonarr.tv/donate  click here]
 
* Source: [https://github.com/lidarr/Lidarr/ Github]
 
* Source: [https://github.com/lidarr/Lidarr/ Github]
* Feature Requests: Got as great idea drop it on GitHub [github.com/Lidarr/Lidarr/issues here]  
+
* Feature Requests: Got a great idea drop it on GitHub [https://github.com/Lidarr/Lidarr/issues here]
 
<section end=lidarr_system_status_more_info />
 
<section end=lidarr_system_status_more_info />
 
==== Readarr ====
 
==== Readarr ====
 
<section begin=readarr_system_status_more_info />
 
<section begin=readarr_system_status_more_info />
 
* Home page: [https://readarr.com Readarr's home page]
 
* Home page: [https://readarr.com Readarr's home page]
* Reddit: [https://reddit.com/r/readarr]
+
* Wiki: [https://wiki.servarr.com/Readarr You're here already]
* Discord: [https://discord.com/invite/rkEXY2Rbgn Join our discord]
+
* Reddit: [https://reddit.com/r/readarr r/readarr]
* Wiki: [https://wiki.servarr.com You're here already]
+
* Discord: [https://readarr.com/discord Join our discord]
 
* Donations: If you're feeling generous and would like to donate click [https://opencollective.com/readarr here]
 
* Donations: If you're feeling generous and would like to donate click [https://opencollective.com/readarr here]
 +
* Donations to Sonarr: If you're feeling generous and would like to donate to the project that started it all [https://sonarr.tv/donate  click here]
 
* Source: [https://github.com/Readarr/Readarr Github]
 
* Source: [https://github.com/Readarr/Readarr Github]
* Feature Requests: Got as great idea drop it [https://github.com/Readarr/Readarr/issues here]
+
* Feature Requests: Got a great idea drop it [https://github.com/Readarr/Readarr/issues click here]
 
<section end=readarr_system_status_more_info />
 
<section end=readarr_system_status_more_info />
  
 
=== Templates ===
 
=== Templates ===

Latest revision as of 00:32, 14 May 2021

System

Health

Overview

Radarr

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.

Sonarr

This page contains a list of health checks errors. These health checks are periodically performed performed by Sonarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.

Lidarr

This page contains a list of health checks errors. These health checks are periodically performed performed by Lidarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.

Readarr

This page contains a list of health checks errors. These health checks are periodically performed performed by Readarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.

System Warnings

Radarr
  • 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 on develop or nightly 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 via arch=x64 in the url. For ARM use arch=arm and for ARM64 use arch=arm64
        • sudo systemctl stop radarr Stop Radarr
        • sudo mv /opt/Radarr /opt/Radarr.old Backup the old Binaries
        • tar -xvzf Radarr*.linux-core-x64.tar.gz Extract the Radarr Tarball
        • sudo mv Radarr/ /opt Move the new Radarr Binaries
        • sudo chown -R radarr:radarr /opt/Radarr Ensure Radarr has permissions to its directory, this assumes it runs as the user radarr
        • sudo rm -rf /opt/Radarr.old Remove the old binaries
        • sudo 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 call Radarr instead of calling it with mono like mono --debug Radarr.exe. In other words you want, as an example, /opt/Radarr/Radarr and not mono --debug /opt/Radarr/Radarr.
        • systemctl daemon-reload Reload the Systemd Files
        • sudo systemctl start radarr.service Restart Radarr
  • 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.
  • 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)
  • 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.
  • 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;
    • For Apache2 reverse proxy, you need to enable the following modules: proxy, proxy_http, and proxy_wstunnel. Then, add this websocket tunnel directive to your vhost configuration:
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
 proxy /radarr 127.0.0.1:7878 {
     websocket
     transparent
 }
  • 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
  • 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.


Sonarr
  • Currently installed .Net Framework is old and unsupported
    • Sonarr uses the .Net Framework. We need to build Sonarr against the lowest supported version still used by our users. Occasionally we increase the version we build against to be able to utilize new features. Apparently you haven't applied the appropriate Windows updates in a while and need to upgrade .Net to be able to use newer versions of Sonarr.
    • Upgrading the .Net Framework is very straightforward on Windows, although it often requires a restart. Please follow the instructions here.
  • Currently installed mono version is old and unsupported
    • Sonarr is written in .Net and requires Mono to run. Various versions of Sonarr have different minimum versions of Mono to operate correctly. The ideal version of Mono varies per platform.
    • Mono 5.8 is the absolute minimum for Sonarr, but Mono 5.20 is currently recommended.
    • The upgrade procedure for Mono varies per platform.
  • Currently installed mono version is supported but upgrading is recommended
    • Sonarr uses the .Net Framework which Mono implements for your system. We need to build Sonarr against the lowest supported version still used by our users. Upgrading to newer versions allows us to build against newer versions and use new Framework features.
    • The upgrade procedure for Mono varies per platform.
  • 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. But while you're at it, read the change log to find out what the relevant changes were.
    • (This warning will not appear if your current version is less than 14 days old)
  • Updating will not be possible to prevent deleting AppData on Update
    • Sonarr detected that AppData folder for your Operating System is located inside the directory that contains the Sonarr binaries. Normally it would be C:\ProgramData for Windows and, ~/.config for linux.
    • Please look at System -> About to see the current AppData & Startup directories.
    • This means Sonarr 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 Sonarr and copy the current contents of the ~/.config/Sonarr directory to preserve your database.
  • Package Maintainer Message
    • Please refer to the specific message your package maintainer is indicating to you. This is not a Sonarr issue. For additional information, refer to your package maintainer. Your package maintainer can be found in System -> Status -> About. Note that this includes docker and your package maintainer is whomever maintains your docker image.
  • 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
  • Mono Legacy TLS enabled
    • Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option


Lidarr
  • Update to .NET Core version
    • Newer versions of Lidarr are targeted for .NET. We will soon no longer provide legacy mono builds for those platforms that cannot use .NET. 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 develop branch. If you are on nightly you'll need to adjust /develop/ in the URL.
      • Delete your existing binaries (contents or folder of /opt/Lidarr) 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://lidarr.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 via arch=x64 in the url. For ARM use arch=arm and for ARM64 use arch=arm64
        • sudo systemctl stop lidarr.service Stop Lidarr
        • sudo mv /opt/Lidarr /opt/Lidarr.old Backup the old Binaries
        • tar -xvzf Lidarr*.linux-core-x64.tar.gz Extract the Lidarr Tarball
        • sudo mv Lidarr/ /opt Move the new Lidarr Binaries
        • sudo chown -R lidarr:lidarr /opt/Lidarr Ensure Lidarr has permissions to its directory, this assumes it runs as the user lidarr
        • sudo rm -rf /opt/Lidarr.old Remove the old binaries
        • sudo rm -rf Lidarr*.linux-core-x64.tar.gz Remove the Tarball
        • Update your startup script ( sudo nano -e /etc/systemd/system/lidarr.service) to call Lidarr instead of calling it with mono like mono --debug Lidarr.exe. In other words you want, as an example, /opt/Lidarr/Lidarr and not mono --debug /opt/Lidarr/Lidarr.
        • systemctl daemon-reload Reload the Systemd Files
        • sudo systemctl start lidarr.service Restart Lidarr
  • 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)
  • Branch is for a previous version
    • The update branch setup in Settings/General is for a previous version of Lidarr, 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
    • For Apache2 reverse proxy, you need to enable the following modules: proxy, proxy_http, and proxy_wstunnel. Then, add this websocket tunnel directive to your vhost configuration:
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /(.*) ws://127.0.0.1:8686/$1 [P,L]

Lidarr can use chromaprint audio fingerprinting to identify tracks. This depends on an external binary, which is distributed with Lidarr for Windows and macOS, but must be provided independently on Linux.

To fix this on a native Linux instance, install the appropriate package using your package manager and make sure that fpcalc is on your PATH (this can be checked using which fpcalc and verifying that the correct location of fpcalc is returned):

Distribution Package
Debian/Ubuntu libchromaprint-tools
Fedora/CentOS chromaprint-tools
Arch chromaprint
OpenSUSE chromaprint-fpcalc
Synology chromaprint
  • 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
  • Mono Legacy TLS enabled
    • Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option


Readarr
  • Update to .NET Core version
    • Newer versions of Readarr are targeted for .NET. We will soon no longer provide legacy mono builds for those platforms that cannot use .NET. You are running one of these legacy builds but your platform supports .NET Core.
    • 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 on develop or nightly you'll need to adjust /master/ in the URL.
      • Delete your existing binaries (contents or folder of /opt/Readarr) 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://readarr.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 via arch=x64 in the url. For ARM use arch=arm and for ARM64 use arch=arm64
        • sudo systemctl stop readarr Stop Readarr
        • sudo mv /opt/Readarr /opt/Readarr.old Backup the old Binaries
        • tar -xvzf Readarr*.linux-core-x64.tar.gz Extract the Readarr Tarball
        • sudo mv Readarr/ /opt Move the new Readarr Binaries
        • sudo chown -R readarr:readarr /opt/Readarr Ensure Readarr has permissions to its directory, this assumes it runs as the user readarr
        • sudo rm -rf /opt/Readarr.old Remove the old binaries
        • sudo rm -rf Readarr*.linux-core-x64.tar.gz Remove the Tarball
        • Update your startup script ( sudo nano -e /etc/systemd/system/readarr.service) to call Readarr instead of calling it with mono like mono --debug Readarr.exe. In other words you want, as an example, /opt/Readarr/Readarr and not mono --debug /opt/Readarr/Readarr.
        • systemctl daemon-reload Reload the Systemd Files
        • sudo systemctl start readarr.service Restart Readarr
  • 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)
  • Branch is for a previous version
    • The update branch setup in Settings/General is for a previous version of Lidarr, 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
    • For Apache2 reverse proxy, you need to enable the following modules: proxy, proxy_http, and proxy_wstunnel. Then, add this websocket tunnel directive to your vhost configuration:
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /(.*) ws://127.0.0.1:8787/$1 [P,L]
  • 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
  • Mono Legacy TLS enabled
    • Mono 4.x tls workaround still enabled, consider removing MONO_TLS_PROVIDER=legacy environment option


Download Clients

Radarr
  • 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.
  • Download clients are unavailable due to failure
    • 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."
      • 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.

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.
  • 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.


Sonarr
  • No download client is available
    • A properly configured and enabled download client is required for Sonarr to be able to download media. Since Sonarr supports different download clients, you should determine which best matches your requirements. If you already have a download client installed, you should configure Sonarr to use it and create a category. See Settings -> Download Client.
  • Unable to communicate with download client
    • Sonarr 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 Sonarr.
      • Ensure SSL encryption is not turned on if you're using both your Sonarr instance and your download client on a local network. See the SSL FAQ entry for more information.
  • Download clients are unavailable due to failure
    • One or more of your download clients is not responding to requests made by Sonarr. Therefore Sonarr 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, Sonarr 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 Sonarr to prevent the errors.
  • 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.
  • Permissions Error
    • Sonarr or the user sonarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.


Lidarr
  • No download client is available
    • A properly configured and enabled download client is required for Lidarr to be able to download media. Since Lidarr supports different download clients, you should determine which best matches your requirements. If you already have a download client installed, you should configure Lidarr to use it and create a category. See Settings -> Download Client.
  • Unable to communicate with download client
    • Lidarr 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 Lidarr.
      • Ensure SSL encryption is not turned on if you're using both your Lidarr instance and your download client on a local network. See the SSL FAQ entry for more information.
  • Download clients are unavailable due to failure
    • One or more of your download clients is not responding to requests made by Lidarr. Therefore Lidarr 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, Lidarr 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 Lidarr to prevent the errors.
  • Enable Completed Download Handling
    • Lidarr 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 Lidarr
      • An example of this would be:
        • Download client: Download Path: /downloads:/mnt/user/downloads
        • Lidarr: Download Path: /data:/mnt/user/downloads
        • Within this example the download client places its downloads into /downloads and therefore tells Lidarr when its complete that the finished song is in /downloads. Lidarr then comes along and says "Okay, cool, let me check in /downloads" Well, inside Lidarr 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 Lidarr is a big fan of simply using /data.
          • Download client: /data:/mnt/user/data
          • Lidarr: /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)/audio and since you used /data in Lidarr when the download client tells Lidarr it's done Lidarr will come along and say "Sweet, I have a /data and I also can see /torrents (or usenet)/audio all is right in the world."
      • 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.
  • 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.
  • Permissions Error
    • Lidarr or the user lidarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.


Readarr
  • No download client is available
    • A properly configured and enabled download client is required for Readarr to be able to download media. Since Readarr supports different download clients, you should determine which best matches your requirements. If you already have a download client installed, you should configure Lidarr to use it and create a category. See Settings -> Download Client.
  • Unable to communicate with download client
    • Readarr 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 Readarr.
      • Ensure SSL encryption is not turned on if you're using both your Readarr instance and your download client on a local network. See the SSL FAQ entry for more information.
  • Download clients are unavailable due to failure
    • One or more of your download clients is not responding to requests made by Readarr. Therefore Readarr 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, Readarr 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 Readarr to prevent the errors.
  • Enable Completed Download Handling
    • Readarr 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 Readarr
      • An example of this would be:
        • Download client: Download Path: /downloads:/mnt/user/downloads
        • Readarr: 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 book is in /downloads. Readarr then comes along and says "Okay, cool, let me check in /downloads" Well, inside Readarr 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 Readarr is a big fan of simply using /data.
          • Download client: /data:/mnt/user/data
          • Readarr: /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)/books and since you used /data in Readarr when the download client tells Readarr it's done Readarr will come along and say "Sweet, I have a /data and I also can see /torrents (or usenet)/books all is right in the world."
      • 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.
  • 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.
  • Permissions Error
    • Readarr or the user readarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.


Completed/Failed Download Handling

Radarr
  • 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.


Sonarr
  • 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, Sonarr 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 Sonarr are on the same machine since it gets the path to be imported directly from the


Lidarr
  • 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, Lidarr 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 Lidrr are on the same machine since it gets the path to be imported directly from the download client otherwise a remote map is needed.


Readarr
  • 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, Readarr 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 Readarr 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

Radarr


Sonarr
Lidarr
Readarr


Folders

Radarr
  • 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
        1. Easiest way to find this is to go to the Movies (Library) Tab
        2. Create a custom filter with the old root folder path
        3. 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.
        4. 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
Sonarr
  • Missing root folder
    • This error is typically identified if a series 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 series that is still using the old root folder and edit it to the correct root folder
        1. Go to the Series > Mass Editor Tab
        2. Create a custom filter with the old root folder path
        3. Once the series have been found find the Root Paths drop down and select the new root path that you want these series to be moved to.
        4. Next you'll receive a pop-up that states Would you like to move the series folders to '<root path>'? Simply select No if the you do not want Sonarr to move your files
  • Import List missing root folder
    • This error is typically identified if a list is looking for a root folder but that root folder is no longer available.
      1. Go to Settings > Import Lists
      2. Edit the import lists that were mentioned in the health check
      3. Save
Lidarr
  • Missing root folder
    • This error is typically identified if an artist 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 artist that is still using the old root folder and edit it to the correct root folder
        1. Go to the Library > Mass Editor Tab
        2. Create a custom filter with the old root folder path
        3. Once the series have been found find the Root Paths drop down and select the new root path that you want these artists to be moved to.
        4. Next you'll receive a pop-up that states Would you like to move the artist folders to '<root path>'? Simply select No if the you do not want Lidarr to move your files
Readarr
  • Missing root folder
    • This error is typically identified if an author 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 author that is still using the old root folder and edit it to the correct root folder
        1. Go to the Library > Mass Editor Tab
        2. Create a custom filter with the old root folder path
        3. Once the series have been found find the Root Paths drop down and select the new root path that you want these authors to be moved to.
        4. Next you'll receive a pop-up that states Would you like to move the author folders to '<root path>'? Simply select No if the you do not want Readarr to move your files


Media

Radarr
  • 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
  • Lists are unavailable due to failures
    • 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.
Sonarr
  • Series Removed from TheTVDB
    • The affected series were removed from TheTVDB, this usually happens because it is a duplicate or considered part of a different series. To correct you will need to remove the affected series and add the correct series.
Lidarr

Text

Readarr

Text


Disk Space

Radarr

  • 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

Sonarr

  • 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

Lidarr

  • 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

Readarr

  • 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

Radarr

This will tell you about your current install of Radarr

Sonarr

This will tell you about your current install of Radarr

Lidarr

This will tell you about your current install of Lidarr

Readarr

This will tell you about your current install of Readarr


More Info

Radarr

Sonarr

Lidarr

Readarr


Templates