ReadAIrr is a renamed fork of Readarr. Some inherited screenshots, executable names, config keys, API labels, and custom-script environment variables still say
Readarrwhere the current app repo still requires that compatibility name. {.is-info}
#Table of Contents
- Table of Contents
- Status
- Health
- System Warnings
- Metadata Issues Message
- Branch is not a valid release branch
- Currently installed SQLite version is not supported
- New update is available
- Cannot install update because startup folder is not writable by the user
- Updating will not be possible to prevent deleting AppData on Update
- Branch is for a previous version
- Could not connect to signalR
- Failed to resolve the IP Address for the Configured Proxy Host
- Proxy Failed Test
- System Time is off by more than 1 day
- Download Clients
- No download client is available
- Unable to communicate with download client
- Download clients are unavailable due to failure
- Enable Completed Download Handling
- Docker bad remote path mapping
- Downloading into Root Folder
- Bad Download Client Settings
- Bad Remote Path Mapping
- Permissions Error
- Author Mount is Read Only
- Remote File was removed part way through processing
- Remote Path is Used and Import Failed
- Completed/Failed Download Handling
- Indexers
- Enabled indexers do not support searching
- Book Folders
- Import Lists
- System Warnings
- Disk Space
- About
- More Info
- Health
- Tasks
- Backup
- Updates
- Events
- Log Files
#Status
The live System section has tabs for Status, Tasks, Backup, Updates, Events, and Log Files. The Status page currently shows Health, Disk Space, About, Database Migration, Metadata Service, and More Info panels.
#Health
- This page contains a list of health check errors. These health checks are periodically performed by ReadAIrr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.
#System Warnings
#Metadata Issues Message
{#we-are-currently-experiencing-issues-with-our-metadata-provider-this-will-prevent-user-searches-and-author-refreshes-from-working-we-are-working-to-solve-the-issue}
- Please see ReadAIrr Metadata Source. Current builds default to
https://api.bookinfo.pro, can usehttps://hardcover.bookinfo.pro, and can be pointed at a custom compatiblerreading-glassesURL fromSettings=>Development.
#Branch is not a valid release branch
- The branch you have set is not a valid release branch. You will not receive updates. Please change to one of the current release branches
#Currently installed SQLite version is not supported
- ReadAIrr stores its data in an SQLite database. The SQLite3 library installed on your system is too old. ReadAIrr requires at least version 3.9.0. Note that ReadAIrr uses
libSQLite3.sowhich may or may not be contained in a SQLite3 upgrade package.
Note that ReadAIrr uses
libSQLite3.sowhich may or may not be contained in a SQLite3 upgrade package. {.is-info}
#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 {.is-info}
#Cannot install update because startup folder is not writable by the user
- This means ReadAIrr will be unable to update itself. You’ll have to update ReadAIrr manually or set the permissions on ReadAIrr’s Startup directory (the installation directory) to allow ReadAIrr to update itself.
#Updating will not be possible to prevent deleting AppData on Update
ReadAIrr detected that AppData folder for your Operating System is located inside the directory that contains the ReadAIrr 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 ReadAIrr 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 ReadAIrr and copy the current contents of the ~/.config/ReadAIrr directory to preserve your database.
#Branch is for a previous version
- The update branch setup in Settings/General is for a previous version of ReadAIrr, 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
- 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 {.is-warning}
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]
For Caddy (V1) use this: Note: you will also need to add the websocket directive to your readarr configuration
proxy /readarr 127.0.0.1:8787 {
websocket
transparent
}
#Failed to resolve the IP Address for the Configured Proxy Host
- Review your proxy settings and ensure they are accurate
- Ensure your proxy is up, running, and accessible
#Proxy Failed Test
- Your configured proxy failed to test successfully, review the HTTP error provided and/or check logs for more details.
#System Time is off by more than 1 day
- System time is off by more than 1 day. Scheduled tasks may not run correctly until the time is corrected
- Review your system time and ensure it is synced to an authoritative time server and accurate
#Download Clients
#No download client is available
- A properly configured and enabled download client is required for ReadAIrr to be able to download media. Since ReadAIrr supports different download clients, you should determine which best matches your requirements. If you already have a download client installed, you should configure ReadAIrr to use it and create a category. See Settings => Download Client.
#Unable to communicate with download client
- ReadAIrr 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 will need to have the same one entered into ReadAIrr.
- Ensure SSL encryption is not turned on if you're using both your ReadAIrr instance and your download client on a local network. See the SSL FAQ entry for more information.
#Download clients are unavailable due to failure
{#download-clients-are-unavailable-due-to-failures}
- One or more of your download clients is not responding to requests made by ReadAIrr. Therefore ReadAIrr 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, ReadAIrr 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 ReadAIrr to prevent the errors.
#Enable Completed Download Handling
- ReadAIrr 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 ReadAIrr
An example of this would be:
- Download client: Download Path: /mnt/user/downloads:/downloads
- ReadAIrr: Download Path: /mnt/user/downloads:/data
Within this example the download client places its downloads into /downloads and therefore tells ReadAIrr when its complete that the finished book is in /downloads. ReadAIrr then comes along and says "Okay, cool, let me check in /downloads" Well, inside ReadAIrr 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 ReadAIrr is a big fan of simply using /data.
- Download client: /mnt/user/data/downloads:/data/downloads
- ReadAIrr: /mnt/user/data:/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 ReadAIrr when the download client tells ReadAIrr it's done ReadAIrr 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: our wiki Docker Guide and TRaSH's Hard links and Instant Moves (Atomic-Moves). Now these guides place heavy emphasis on Hard links and Atomic moves, but the general concept of containers and how path mapping works is the core of these discussions.
If you're crossing operating systems or native and docker then you need a remote path map. See TRaSH's Remote Path Guide for Radarr but the concept is the same for all *Arrs for more information.
If you are getting this error with Calibre then Redarr is unable to access Calibre's Library. The resolution is the same - correct the inconsistent mounts for your containers. Alternatively, create a remote path mapping to map the Calibre Library path to the ReadAIrr accessible path. A remote path map is only ever needed if crossing operating systems or servers. If everything is in Docker it is preferred to correct your mounts instead.
#Downloading into Root Folder
{#downloads-in-root-folder}
- Within the application, a root folder is defined as the configured media library folder. This is not the root folder of a mount. Your download client has an incomplete or complete (or is moving completed downloads) into your root (library) folder.
- This frequently causes issues - including data loss - and should not be done. To fix this change your download client so it is not placing downloads within your root folder. Note that 'placing' also includes if your download client category is set to your root folder or if NZBGet/SABnzbd have sort enabled and are sorting to your root folder.
- Please note that this check looks at all defined/configured root folders added not only root folders currently in use. In other words, the folder your download client downloads into or moves completed downloads to, should not be the same folder you have configured as your root/library/final media destination folder in the *arr application.
- Configured Root Folders (aka Library folders) can be found in Settings => Media Management => Root Folders
- One example is if your downloads are going into
\data\downloadsthen you have a root folder set as\data\downloads. - It is suggested to use paths like
\data\media\for your root folder/library and\data\downloads\for your downloads. - Review our Docker Guide and TRaSH's Hard links and Instant Moves (Atomic-Moves) Guide for more information on the correct and optimal path setup. Note that the concepts apply for docker and non-docker
Your download folder where your download client places the downloads and your root/library folder MUST be separate. *Arr will import the file(s) from your download client's folder into your library. The download client should not move anything or download anything to your library. {.is-warning}
#Bad Download Client Settings
- The location your download client is downloading files to is causing problems. Check the logs for further information. This may be permissions or attempting to go from windows to linux or linux to windows without a remote path map.
#Bad Remote Path Mapping
- The location your download client is downloading files to is causing problems. Check the logs for further information. This may be permissions or attempting to go from windows to linux or linux to windows without a remote path map. See TRaSH's Remote Path Guide for more information.
#Permissions Error
- ReadAIrr or the user readarr is running as cannot access the location your download client is downloading files to. This is typically a permission issue.
#Author Mount is Read Only
{#author-mount-ro}
- Mount containing a author path is mounted read-only. Check your mount settings and ownership/permissions.
#Remote File was removed part way through processing
- A file accessible via a remote path map appears to have been removed prior to processing completing.
#Remote Path is Used and Import Failed
- Check your logs for more info; Refer to our Troubleshooting Guides
#Completed/Failed Download Handling
#Completed Download Handling is disabled
- (This warning is only generated for existing users before when the Completed Download Handling feature was implemented. This feature is disabled by default to ensure the system continued to operate as expected for current configurations.)
- It’s recommended to use Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients. With it, ReadAIrr 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 ReadAIrr are on the same machine since it gets the path to be imported directly from the download client otherwise a remote map is needed.
#Download Client Removes Completed Downloads
{#download-client-removes-completed-downloads}
- It's required that your download client retain its history of completed downloads until ReadAIrr has imported them. If history retention is disabled then *Arr may not see the completed download before it is removed from the download client. Your download client should be set to keep (usenet) and pause not remove (torrents) downloads after completion: either indefinitely or for at least 14 days.
- Sabnzbd: Switches => Post Processing => Keep Jobs must be set to 14 days or greater OR be set to Keep All History
- Removing completed downloads from your client can be managed by ReadAIrr and enabled via the download client settings in *Arr. Thus *Arr can ensure that your download client history is cleaned up.
#Indexers
#No indexers available with automatic search enabled, ReadAIrr will not provide any automatic search results
- Simply put you do not have any of your indexers set to allow automatic searches
- Go into Settings => Indexers, select an indexer you'd like to allow Automatic Searches and then click save.
#No indexers available with RSS sync enabled, ReadAIrr will not grab new releases automatically
- So ReadAIrr uses the RSS feed to pick up new releases as they come along. More info on that here
- To correct this issue go to Settings => Indexers, select an indexer you have and enable RSS Sync
#No indexers are enabled
- ReadAIrr requires indexers to be able to discover new releases. Please read the wiki on instructions how to add indexers.
#Enabled indexers do not support searching
- None of the indexers you have enabled support searching. This means ReadAIrr 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.
#No indexers available with Interactive Search Enabled
- None of the indexers you have enabled support interactive searching. This means the application will only be able to find new releases via the RSS feeds or an automatic search.
#Indexers are unavailable due to failures
- Errors occurs while ReadAIrr tried to use one of your indexers. To limit retries, ReadAIrr will not use the indexer for an increasing amount of time (up to 24h).
- This mechanism is triggered if ReadAIrr was unable to get a response from the indexer (could be caused DNS, proxy/vpn connection, authentication, or an indexer issue), or unable to fetch the nzb/torrent file from the indexer. Please inspect the logs to determine what kind of error causes the problem.
- You can prevent the warning by disabling the affected indexer.
- Run the Test on the indexer to force ReadAIrr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.
#Jackett All Endpoint Used
- The Jackett /all endpoint is convenient, but that is its only benefit. Everything else is potential problems, so adding each tracker individually is now required.
- Even Jackett's Devs says it should be avoided and should not be used.
- Using the /all endpoint has no advantages, only disadvantages:
- you lose control over indexer specific settings (categories, search modes, etc.)
- mixing search modes (IMDB, query, etc.) might cause low-quality results
- indexer specific categories (>= 100000) cannot be used.
- slow indexers will slow down the overall result
- total results are limited to 1000
- if one of the trackers in /all returns an error, *Arr will disable it and now you do not get any results.
#Solutions
- Add each tracker in Jackett manually as an indexer in *Arr
- Check out Prowlarr which can sync indexers to *Arr and from the Lidarr/Radarr/ReadAIrr development team.
- Check out NZBHydra2 which can sync indexers to *Arr. But do not use their single aggregate endpoint and use
multiif sync will be used.
#Book Folders
#Missing Root Folder
This error is typically identified if a Author is looking for a root folder but that root folder is no longer available.
This error may also be if a list is still pointed at a root folder but that root folder is no longer available.
If you would like to remove this warning simply find the album that is still using the old root folder and edit it to the correct root folder.
Easiest way to find the problem author is to:
- Go to the Author (Library) Tab
- Create a custom filter with the old root folder path
- Select mass edit on the top bar and from the Root Paths drop down select the new root path that you want these author to be moved to.
- Next you will receive a pop-up that states Would you like to move the Author folders to 'root path' ? This will also state This will also rename the Author folder per the Author folder format in settings. Simply select No if the you do not want Lidarr to move your files
- Run the Check Health Task in System => Tasks
#Import Lists
#Import Lists are unavailable due to failures
- Typically this simply means that ReadAIrr is no longer able to communicate via API or via logging in to your chosen list provider. Your best bet if the problem persists is to contact them in order to rule them out, as their systems maybe overloaded from time to time.
#Disk Space
- This section will show you available disk space
- In docker this can be tricky as it will typically show you the available space within your Docker image
#About
- This will tell you about your current install of ReadAIrr, including version, package version, runtime, Docker status, database type/version, migration version, app-data directory, startup directory, mode, and uptime.
The current page also includes:
- Database Migration: active database, readiness, PostgreSQL configuration, credential presence, reachability, backup recommendation, and migration guidance
- Metadata Service: configured metadata source, reachability, confidence signal, and a refresh action
#More Info
- Home Page:
https://readairr.com/ - Documentation:
https://readairr.com/docs/
#Tasks
#Scheduled
This section lists all scheduled tasks that ReadAIrr runs
Application Check Update - This will run every on the displayed schedule in the UI, checking to see if ReadAIrr is on the most current version then triggering the update script to update ReadAIrr. Settings=> Update
Note: If on Docker this will not update your container as a new image will need to be downloaded. {.is-warning}
- Backup - This will run a backup of your ReadAIrr's database on a set schedule more details on this can be found here. More information about backups can be found System => Backups.
- Check Health - Check Health will run on the displayed schedule in the UI checking the overall health of your ReadAIrr. To see a list of possible health related issues see the Wiki Entry on Health Checks.
- Housekeeping - On the displayed schedule in the UI this will dust out all the cobwebs, sweeps and vacuums the floors, mops, shines, and even makes nice neat little folded notes just for you. But does not take out the trash. That it just was not paid enough for.
- Import List Sync - On the displayed schedule in the UI this will run your Lists and import any possible new books. More info about lists can be found Settings => Lists.
- Messaging Cleanup - On the displayed schedule in the UI this cleans up those messages that appear in the bottom left corner of ReadAIrr
- Refresh Author - This goes through and refreshes all authors in your Library.
- Refresh Monitored Downloads - This goes through and refreshes the downloads queue located under Activity. Essentially pinging your download client to check for finished downloads.
- Rescan folders - This scans all book folders to see if a book exists or not, and updates the status of it appropriately.
- RSS Sync - This will run the RSS Sync. This can be changed in settings => options. More information on the RSS function can be found on our FAQ
All these tasks can be ran manually outside their scheduled times by hitting the icon to the far right of each of the tasks. {.is-info}
#Queue
The queue will show you running and upcoming tasks as well as a history of recently ran tasks as well as how long those tasks took.
#Backup
If you're looking for how to back/restore your ReadAIrr instance click the ReadAIrr FAQ backup section. {.is-info}
Within the Backup section you will be presented with previous backups (unless you have a fresh install that hasn't made any backups).
Backup Now - This option will trigger a manual backup of your ReadAIrr's database
Restore Backup - This will open a new screen to restore from a previous backup
- By selecting Choose File this will prompt your browser to open a dialog box to restore from a ReadAIrr backup zip. Older backup filenames or dialogs may still say Readarr.
If you have any previous backups and would like to download them from ReadAIrr to be placed in a non standard location you simply can select one of these files to download them
Off to the right of each of the previous download you have two options.
- Restore (Clock Icon) - To restore from a previous backup - This will open a new window to confirm you want to restore from this backup
- Delete (Trashcan) - To delete a previous backup
#Updates
- The update screen will show the past 5 updates that have been made as well as the current version you are on.
- This page will also display the update notes from the Developers telling you what has been fixed or added to ReadAIrr (Rejoice!)
A Maintenance Release contains bug fixes and other various improvements. Take a look at the commit history for specifics. {.is-info}
#Events
- The events tab will show you what has been happening within your ReadAIrr. This can be used to diagnose some light issues. However, this does not replace Trace Logs discussed in Logging.
Events are the equivalent of INFO Logs. {.is-info}
- Components - This column will tell you what component within ReadAIrr has been triggered
- Message - This column will tell you what message as been sent from the component from the previous column.
- Gear Icon - This option will allow you to change how many Components/Messages are displayed per page (Default is 50)
- Options at the top of the page
- Refresh - This option will refresh the current page, pulling a new events log
- Clear - This will clear the current events log allowing you to start from fresh
#Log Files
This page will allow you to download and see what current log files are available for ReadAIrr
On the top row there are several options to allow you to control your log files.
The top row on the far left there is a dropdown that will allow you to switch from Log files and Updater Log Files
- Log Files - The bread and butter of any support issue more on log files can be found here.
- Updater Log Files - This will show the log files associated with ReadAIrr's updater script
If you're on docker this will be empty as you should be updating by downloading a new docker image {.is-info}
- Refresh - This will refresh the current page and display any newly created logs
- Delete - This will clear all logs allowing you to start from fresh
- File Name - This will display the file name associated with the log
- Last Written - This is the local time that this particular log file was written to.
- ReadAIrr uses rolling log files limited to 1MB each. The current log file is always readarr.txt, for the the other files readarr.0.txt is the next newest (the higher the number the older it is) up to 51 log files total. This log file contains
fatal,error,warn, andinfoentries. - When Debug log level is enabled, additional readarr.debug.txt rolling log files will be present, up to 51 files. This log files contains
fatal,error,warn,info, anddebugentries. It usually covers a ~40h period. - When Trace log level is enabled, additional readarr.trace.txt rolling log files will be present, up to 51 files. This log files contains
fatal,error,warn,info,debug, andtraceentries. Due to trace verbosity it only covers a couple of hours at most.
- ReadAIrr uses rolling log files limited to 1MB each. The current log file is always readarr.txt, for the the other files readarr.0.txt is the next newest (the higher the number the older it is) up to 51 log files total. This log file contains