Prowlarr FAQ | Servarr Wiki (https://wiki.servarr.com/prowlarr/faq#i-am-getting-an-error-database-disk-image-is-malformed) Servarr Wiki Search... (https://wiki.servarr.com/t) (https://wiki.servarr.com/login) Browse (https://wiki.servarr.com/) Home Applications (https://wiki.servarr.com/en/radarr) Radarr (https://wiki.servarr.com/en/sonarr) Sonarr (https://wiki.servarr.com/en/lidarr) Lidarr (https://wiki.servarr.com/en/readarr) Readarr (https://wiki.servarr.com/en/whisparr) Whisparr (https://wiki.servarr.com/en/prowlarr) Prowlarr Contribute (https://wiki.servarr.com/en/donate) Donate (https://wiki.servarr.com/en/bug-report) Report a Bug Suggest a Feature (https://github.com/Servarr/Wiki) Github Support (https://radarr.video/discord) Discord / (https://wiki.servarr.com/en/prowlarr) prowlarr / (https://wiki.servarr.com/en/prowlarr/faq) faq Prowlarr FAQ Prowlarr FAQ Page Contents Table of Contents Forced Authentication How do I reset Stats? Category Not Available or Missing Can I add any (generic) Torrent RSS Feed? Can I add any (generic) Torznab or Newznab indexer? Can I use flaresolverr indexers? How can I add an indexer that is down or not functional? Prowlarr will not sync to Sonarr Prowlarr will not sync X Indexer to App What *Arr Indexer Settings are Compared for App Full Sync How do I update Prowlarr? Can I switch from nightly back to develop? Can I switch between branches? Help, my Mac says Prowlarr cannot be opened because the developer cannot be verified Help, my Mac says Prowlarr.app is damaged and can’t be opened How do I request a feature for Prowlarr? I am getting an error: Database disk image is malformed I use Prowlarr on a Mac and it suddenly stopped working. What happened? How do I change from the Windows Service to a Tray App? How do I Backup/Restore Prowlarr? WebUI only Loads at localhost on Windows Finding Cookies I got a pop-up that said config.xml was corrupt, what now? Invalid Certificate and other HTTPS or SSL issues Help I have locked myself out Weird UI Issues VPNs, Jackett, and the *ARRs How do I stop the browser from launching on startup? Can I easily add all indexers at once? Tags (https://wiki.servarr.com/t/prowlarr) prowlarr (https://wiki.servarr.com/t/faq) faq (https://wiki.servarr.com/t/prowlarr/faq) Last edited by bakerboy44801 03/30/2025 ¶ Table of Contents Table of Contents Forced Authentication Authentication Method Authentication Required How do I reset Stats? Category Not Available or Missing Can I add any (generic) Torrent RSS Feed? Can I add any (generic) Torznab or Newznab indexer? Can I use flaresolverr indexers? How can I add an indexer that is down or not functional? Prowlarr will not sync to Sonarr Prowlarr will not sync X Indexer to App What *Arr Indexer Settings are Compared for App Full Sync How do I update Prowlarr? Can I update Prowlarr inside my Docker container? Installing a newer version Native Docker Can I switch from nightly back to develop ? Can I switch between branches? Help, my Mac says Prowlarr cannot be opened because the developer cannot be verified Help, my Mac says Prowlarr.app is damaged and can’t be opened How do I request a feature for Prowlarr? I am getting an error: Database disk image is malformed I use Prowlarr on a Mac and it suddenly stopped working. What happened? How do I change from the Windows Service to a Tray App? How do I Backup/Restore Prowlarr? Backing up Prowlarr Using built-in backup Using file system directly Restoring from Backup Using zip backup Using file system backup File System Restore on Synology NAS WebUI only Loads at localhost on Windows Finding Cookies I got a pop-up that said config.xml was corrupt, what now? Invalid Certificate and other HTTPS or SSL issues Help I have locked myself out Weird UI Issues VPNs, Jackett, and the *ARRs Use of a VPN How do I stop the browser from launching on startup? Can I easily add all indexers at once? ¶ Forced Authentication If Prowlarr is exposed so that the UI can be accessed from outside your local network then you should have some form of authentication method enabled in order to access the UI. This is also increasingly required by Trackers and Indexers. As of Prowlarr v1, Authentication is Mandatory. AuthenticationType and AuthenticationMethod are mandatory required attributes in the configuration file. ¶ Authentication Method Basic (Browser pop-up) - This option when accessing your Prowlarr will show a small pop-up allowing you to input a Username and Password. Note this is not recommended and will be removed in the next major version. Forms (Login Page) - This option will have a familiar looking login screen much like other websites have to allow you to log onto your Prowlarr. This is recommended. External - Configurable via Config File Only Disables app authentication completely. Use at your own risk especially if exposed to the internet Suggested only if you use an external authentication such as Authelia, Authetik, NGINX Basic auth, etc. you can prevent needing to double authenticate by shutting down the app, setting External in the (https://wiki.servarr.com/prowlarr/appdata-directory) config file , and restarting the app. Note that multiple AuthenticationMethod entries in the file are not supported and only the topmost value will be used ¶ Authentication Required If you do not expose the app externally and/or do not wish to have auth required for local (e.g. LAN) access then change in Settings => General Security => Authentication Required to Disabled For Local Addresses The config file equivalent of this is DisabledForLocalAddresses Enabled is also a valid value ¶ How do I reset Stats? To reset your stats and clear history do the following: History => Options Set History Cleanup to 1 . This will keep only through yesterday's History and Stats Navigate to System => Tasks Run the Clean Up History Task Run the Housekeeping Task Return to History => Options Set History Cleanup to your desired retention period for History and Stats ¶ Category Not Available or Missing Please note that custom/non-standard indexer specific categories are mapped to standard ones, so searching will standard ones will incorporate all custom ones. Review your specific Indexer's category mapping definition for details. ¶ Can I add any (generic) Torrent RSS Feed? Yes. Use "TorrentRSS". The following attributes are mandatory: guid title infohash enclosure or link The following attributes are optional, but recommended: size pubDate ¶ Can I add any (generic) Torznab or Newznab indexer? Yes. Go to Indexers => Add Indexer (+) => Generic Torznab or Generic Newznab ¶ Can I use flaresolverr indexers? Yes. Configure your flaresolverr instance by adding it as a proxy in (https://wiki.servarr.com/prowlarr/settings#indexer-proxies) Settings => Indexers Add a tag to the created flaresovlerr proxy Add the same tag to your (https://wiki.servarr.com/prowlarr/indexers) Indexer The tags must match & Cloudflare must be detected for Flaresolverr to be used. A Flaresolverr proxy is disabled if no tags are used. (https://trash-guides.info/Prowlarr/prowlarr-setup-flaresolverr/) See TRaSH's Guides on "How to setup Flaresolverr" for more details ¶ How can I add an indexer that is down or not functional? Follow then standard steps to add the indexer noting thr following changes. Uncheck (Disable) the Enabled box Press Save Press Save again to trigger a force save Edit the Indexer (Wrench Icon) Check (Enable) the Enabled box Press Save Press Save again to trigger a force save ¶ Prowlarr will not sync to Sonarr Prowlarr only supports Sonarr v3+ Sonarr v2 (fka nzbdrone) is not supported by Prowlarr nor supported in general and has been end-of-life since March 2021 ¶ Prowlarr will not sync X Indexer to App Prowlarr only syncs if Add and Remove or Full Sync is enabled for the app. Only in instances where an App and Indexer have matching tags or no tags at all will an indexer be synced to an app Indexers are synced based on the capabilities/categories they claim to support. If an indexer supports only TV categories it will not be synced to Lidarr, Radarr, and Readarr. A given indexer will only be synced to Sonarr "Supported" Categories can be selected as an advanced setting on a per app basis. Indexers will not be attempted to be synced if the specific Categories supported by the Indexer are not selected in Settings => Application => {App} => Sync Categories (Advanced Settings) and logs will not show any indication of a sync attempt. The most common cause for this is that the *Arrs only accept indexers whose test queries return results containing at least one of the configured categories. In other words, if you're syncing to an App and your indexer's empty query does not return results with any release within the categories configured for the App then it will be unable to add the indexer to *Arr. The specific error will be be an HTTP 400 from *Arr stating Query successful, but no results in the configured categories were returned from your indexer. This may be an issue with the indexer or your indexer category settings. Possibly that indexer simply cannot be used with that *Arr. This is common for attempting to use public trackers or usenet indexers with Readarr and Lidarr. Adjust the categories synced in the advanced settings for the *Arr application within Prowlarr Note that certain Trackers - primarily "crappy" public trackers - require one to select and sync the 8000 - Other category. This is often - but not always - noted within the Tracker's details within Prowlarr. Try again later If the issue persist you may have a corrupted database. Check your logs for instances of Database disk image is malformed or Error creating main database . See this heading for possible solutions. ¶ What *Arr Indexer Settings are Compared for App Full Sync App/Prowlarr: Indexer Name App/Prowlarr: Enable/Disable RSS App/Prowlarr: Enable/Disable Auto Search App/Prowlarr: Enable/Disable Interactive Search App/Prowlarr: Indexer Priority App/Prowlarr: API Key App/Prowlarr: Url App/Prowlarr: Baseurl App/Prowlarr: Port App/Prowlarr: Categories App/Prowlarr: Seed Ratio and Seed Time App/Prowlarr: Minimum Seeders App/Prowlarr: Any Other Settings configurable/controlled in Prowlarr Prowlarr: Implementation (e.g. YML or C#) With Full Sync enabled, if any of the above change between the *Arr App and Prowlarr then the Indexer will be Synced and Updated in *Arr. ¶ How do I update Prowlarr? Go to Settings and then the General tab and show advanced settings (use the toggle by the save button). Under the Updates section change the branch name to master , develop , or nightly Save This will not install the bits from that branch immediately, it will happen during the next update. master - (Current Master/Stable) - (Default/Stable): It has been tested by users on the develop and nightly branches and it’s not known to have any major issues. On GitHub, this is the master branch. develop - (Current Develop/Beta) - (Beta): This is the testing edge. Released after tested in nightly to ensure no immediate issues. New features and bug fixes released here first after nightly. It can be considered semi-stable, but is still beta . On GitHub, this is a snapshot of the develop branch at a specific point in time and is tagged as pre-release. nightly - (Current Nightly/Unstable) - (Alpha/Unstable): This is the bleeding edge. It is released as soon as code is committed and passes all automated tests. This build may have not been used by us or other users yet. There is no guarantee that it will even run in some cases. This branch is only recommended for advanced users. Issues and self investigation are expected in this branch. Use this branch only if you know what you are doing and are willing to get your hands dirty to recover a failed update. This version is updated immediately. Warning: You may not be able to go back to develop after switching to this branch. On GitHub, this is the develop branch. Note: If your install is through Docker append :latest , :testing , :develop , or :nightly to the end of your container tag depending on who makes your builds. master (stable) (Current Master/Stable) develop (beta) (Current Develop/Beta) nightly (unstable) (Current Nightly/Alpha) (https://hotio.dev/containers/prowlarr) hotio latest testing nightly (https://docs.linuxserver.io/images/docker-prowlarr) LinuxServer.io latest develop nightly ¶ Can I update Prowlarr inside my Docker container? Technically, yes. But you absolutely should not. It is a primary philosophy of Docker. Database issues can arise if you upgrade your installation inside to the most recent nightly , but then update the Docker container itself (possibly downgrading to an older version). ¶ Installing a newer version ¶ Native Go to System and then the Updates tab Newer versions that are not yet installed will have an update button next to them, clicking that button will install the update. ¶ Docker Repull your tag and update your container ¶ Can I switch from nightly back to develop ? ¶ Can I switch between branches? If version is identical you can switch, otherwise check with the development team to see if you can switch from nightly to develop ; or develop to nightly for your given build. Failure to follow these instructions may result in your Prowlarr becoming unusable or throwing errors. You have been warned The most common errors are database errors around missing columns or tables. ¶ Help, my Mac says Prowlarr cannot be opened because the developer cannot be verified This is simple, please see this link for more information (https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) here Alternatively, you may need to self-sign Prowlarr codesign --force --deep -s - /Applications/Prowlarr.app && xattr -rd com.apple.quarantine (faq_1_mac.png) ¶ Help, my Mac says Prowlarr.app is damaged and can’t be opened That is either due to a corrupt download (so try again), or security issues answered just above this. ¶ How do I request a feature for Prowlarr? To request a feature for Prowlarr, first search on GitHub to ensure no similar request exists, then (https://github.com/Prowlarr/Prowlarr/issues/new?assignees=&labels=feature+request&template=feature_request.md&title=) click here to add your request. ¶ I am getting an error: Database disk image is malformed Errors of Error creating log database indicate issues with logs.db This can quickly be resolved by renaming or removing the database. The logs database contains unimportant information regarding commands history and update install history, and Info, Warn, and Error entries Errors of Error creating main database or generic database disk image is malformed with no specified database indicate issues with prowlarr.db Continue with the steps noted below This means your SQLite database that stores most of the information for Prowlarr is corrupt. Your options are to try (a) backup(s), try recovering the existing database, try recovering the backup(s), or if all else fails starting over with a fresh new database. This error may show if the database file is not writable by the user/group *Arr is running as. Permissions being the cause will likely only be an issue for new installs, migrated installs to a new server, if you recently modified your appdata directory permissions, or if you changed the user and group *Arr run as. Your best and first option is to try restoring from a backup You can also try recovering your database. This is typically the only option for when this issue occurs after an update. Try the (https://wiki.servarr.com/useful-tools#recovering-a-corrupt-db) sqlite3 .recover command If your sqlite does not have .recover or you wish a more GUI (i.e. Windows) friendly way then follow (https://wiki.servarr.com/useful-tools#recovering-a-corrupt-db-ui) our instructions on this wiki. Another possible cause of you getting an error with your Database is that you're placing your database on a network drive (nfs or smb or something else not local). SQLite is designed for situations where the data and application coexist on the same machine. Thus your *Arr AppData Folder (/config mount for docker) MUST be on local storage. (https://www.sqlite.org/draft/useovernet.html) SQLite and network drives not play nice together and will cause a malformed database eventually . If you are using mergerFS you need to remove direct_io as SQLite uses mmap which isn’t supported by direct_io as explained in the mergerFS (https://github.com/trapexit/mergerfs#plex-doesnt-work-with-mergerfs) docs here ¶ I use Prowlarr on a Mac and it suddenly stopped working. What happened? Most likely this is due to a MacOS bug which caused the Prowlarr database to be corrupted. Please check the FAQ entry for restoring a corrupt database. ¶ How do I change from the Windows Service to a Tray App? Shut Prowlarr down Run serviceuninstall.exe that's in the Prowlarr directory Run Prowlarr.exe as an administrator once to give it proper permissions and open the firewall. Once complete, then you can close it and run it normally. (Optional) Drop a shortcut to Prowlarr.exe in the startup folder to auto-start on boot. ¶ How do I Backup/Restore Prowlarr? ¶ Backing up Prowlarr ¶ Using built-in backup Go to System => Backup in the Prowlarr UI Click the Backup button Download the zip after the backup is created for safekeeping ¶ Using file system directly Find the location of the AppData directory for Prowlarr Via the Prowlarr UI go to System => About (https://wiki.servarr.com/prowlarr/appdata-directory) Prowlarr Appdata Directory Stop Prowlarr - This will prevent the database from being corrupted Copy the contents to a safe location ¶ Restoring from Backup Restoring to an OS that uses different paths will not work (Windows to Linux, Linux to Windows, Windows to OS X or OS X to Windows), moving between OS X and Linux may work, since both use paths containing / instead of \ that Windows uses, but is not supported. You'll need to manually edit all paths in the database. ¶ Using zip backup Re-install Prowlarr (if applicable / not already installed) Run Prowlarr Navigate to System => Backup Select Restore Backup Select Choose File Select your backup zip file Select Restore ¶ Using file system backup Re-install Prowlarr (if applicable / not already installed) Find the location of the AppData directory for Prowlarr Running Prowlarr once and via the UI go to System => About (https://wiki.servarr.com/prowlarr/appdata-directory) Prowlarr Appdata Directory Stop Prowlarr Delete the contents of the AppData directory (Including the .db-wal/.db-journal files if they exist) Restore from your backup Start Prowlarr As long as the paths are the same, everything will pick up where it left off ¶ File System Restore on Synology NAS CAUTION: Restoring on a Synology requires knowledge of Linux and Root SSH access to the Synology Device. Re-install Prowlarr (if applicable / not already installed) Find the location of the AppData directory for Prowlarr Running Prowlarr once and via the UI go to System => About (https://wiki.servarr.com/prowlarr/appdata-directory) Prowlarr Appdata Directory Stop Prowlarr Connect to the Synology NAS through SSH and log in as root On some installations, the user is different than the below commands: chown -R sc-Prowlarr:Prowlarr * Execute the following commands: rm -r /usr/local/Prowlarr/var/.config/Prowlarr/Prowlarr.db cp -f /tmp/Prowlarr_backup/* /usr/local/Prowlarr/var/.config/Prowlarr/ Copy Update permissions on the files: cd /usr/local/Prowlarr/var/.config/Prowlarr/ chown -R Prowlarr:users * chmod -R 0644 * Copy Start Prowlarr ¶ WebUI only Loads at localhost on Windows If you can only reach your web interface at http://localhost:9696/ or http://127.0.0.1:9696 , you need to run Prowlarr as Administrator at least once, maybe even always. ¶ Finding Cookies Some sites cannot be logged into automatically and require you to login manually then give the cookies to Prowlarr to work. (https://wiki.servarr.com/useful-tools#finding-cookies) Please see this article for details. ¶ I got a pop-up that said config.xml was corrupt, what now? Prowlarr was unable to read your config file on start-up as it became corrupted somehow. In order to get Prowlarr back online, you will need to delete .xml in your AppData Folder, once deleted start Prowlarr and it will start on the default port (9696), you should now re-configure any settings you configured on the General Settings page. ¶ Invalid Certificate and other HTTPS or SSL issues Your download client stopped working and you're getting an error like Localhost is an invalid certificate ? Prowlarr validates SSL certificates. If there is no SSL certificate set in the download client, or you're using a self-signed https certificate without the CA certificate added to your local certificate store, then Prowlarr will refuse to connect. Free properly signed certificates are available from let's encrypt. If your download client and Prowlarr are on the same machine there is no reason to use HTTPS, so the easiest solution is to disable SSL for the connection. Most would agree it's not required on a local network either. It is possible to disable certificate validation in advanced settings if you want to keep an insecure SSL setup. ¶ Help I have locked myself out Close Prowlarr Open config.xml in a text editor Find the authentication method line will beBasic or Forms (Be sure that you do not have two AuthenticationMethod entries in your file) Change the AuthenticationMethod line to External Restart Prowlarr Prowlarr will now be accessible without a password, you should go the Settings => General in the UI, change the Authentication Method to Basic or Forms and set your new username and password ¶ Weird UI Issues If you experience any weird UI issues or a certain view or sort not working, try viewing in a Chrome Incognito Window or Firefox Private Window. If it works fine there, clear your browser cache and cookies for your specific ip/domain. For more information, see the (https://wiki.servarr.com/useful-tools#clearing-cookies-and-local-storage) Clear Cache Cookies and Local Storage wiki article. ¶ VPNs, Jackett, and the *ARRs Unless you're in a repressive country like China, Australia or South Africa, your torrent client is typically the only thing that needs to be behind a VPN. If you're in a repressive country noted above it is likely your connection to your trackers needs to be VPN'd as well - in other words Jackett behind a VPN or Prowlarr using an Indexer Proxy. Other *Arr apps not connecting to trackers should not be behind a VPN.. Because the VPN endpoint is shared by many users, you can and will experience rate limiting, DDOS protection, and ip bans from various services each software uses. In other words, putting the *Arrs (Lidarr, Prowlarr, Radarr, Readarr, and Lidarr) behind a VPN can and will make the applications unusable in some cases due to the services not being accessible. To be clear it is not a matter if VPNs will cause issues with the *Arrs, but when: image providers will block you and cloudflare is in front of most of *Arr servers (updates, metadata, etc.) and liable to block you too Many private trackers will ban you for using or accessing them (i.e. using Jackett or Prowlarr) via a VPN. ¶ Use of a VPN If a VPN is required and Docker is used it is recommended to use Hotio or Binhex's Download Client + VPN Containers. If a VPN is required and Docker is not used your VPN client must support split tunneling so only the required (Download Client) apps are behind the VPN. Many issues with accessing trackers can be resolved by using Google or Cloudflare's DNS servers in lieu of your ISP's DNS servers. In some cases (i.e. UK ISPs) you may need to put your torrent download client behind a VPN and Jackett/Prowlarr as follows: put Jackett behind the VPN and ensure split tunneling allows local access for Prowlarr configure your vpn client to provide a proxy and add the proxy in Settings => Indexers. Give the proxy a tag and any indexers that need to use it the same tag. If absolutely required and if your vpn does not provide a way to create a proxy you may put Prowlarr behind the VPN and ensure split tunneling allows local access. ¶ How do I stop the browser from launching on startup? Depending on your OS, there are multiple possible ways. In Settings => General on some OS'es, there is a checkbox to launch the browser on startup. When invoking Prowlarr, you can add -nobrowser (*nix) or /nobrowser (Windows) to the arguments. Stop Prowlarr and edit the config.xml file, and change True to False . ¶ Can I easily add all indexers at once? No. This would not be a good thing to do, and this functionality will not be added. It is much better to choose your indexers wisely, pay attention to the stats to remove indexers that are too slow or not producing grabs. Proper pruning and maintenance of your indexers will result in much better results overall, and quicker results on searches from your apps. Powered by (https://wiki.js.org/) Wiki.js