This page will go through all the settings available in Prowlarr and how they work. This is not meant to be a comprehensive "how to set up Prowlarr." If you want that, please use the Quick Start page instead.
To get to the Settings page, please choose Settings from the left menu. The following sub-menu options will be available:
Also, note that for each individual settings page, there are some options at the top of the menu:
Hide/Show advanced is important for any items that are marked below as
(Advanced Option), otherwise they will not show up. These menu items are shown in orange in the screenshots.
You must save your changes before leaving the screen. You do that by clicking the disk icon. If you've made no changes, it will show "No Changes" and be grayed out, as shown above.
Here is where you can add proxies or Flaresolverr configurations for those indexers that require them.
Indexers, and then click the
+ to add a proxy.
Configuring HTTP, SOCKS4, or SOCKS5 proxies are all the same. Enter a name, the hostname/port/userid/password of your proxy server into the appropriate boxes. If you want this to apply to only a specific subset of your indexers, then enter a TAG name here (and then apply that TAG to your indexers you want it to apply to).
Configuring a Flaresolverr server requires you to enter the hostname:port of your Flaresolver installation (which can be found here). Again, applying a TAG allows you to only use Flaresolverr on those indexers which require its use.
Here is where you will add the applications that use Prowlarr (Radarr, Sonarr, Lidarr, Readarr, etc.) and how they stay in sync with Prowlarr.
Apps, and then click the
+ to add an *arr program.
All programs you can add are listed. You should only add programs you currently have installed, and if you have multiple instances of them, you should add each of them separately.
Note: Indexers are synced based on the capibilities/categories they claim to support. If an indexer supports only
tvcategories it will be synced to Sonarr.
Add and Remove Only - When it is added or removed from Prowlarr, it will update your app.
Full Sync - Full Sync will keep your app and Prowlarr fully in sync. Any change made in Prowlarr is then synced to the other program (and to any other program that has Full Sync selected!) Any change made remotely will be overridden by Prowlarr on next sync.
Full Syncmeans Prowlarr will override any in-app customizations including user selected categories.
Disabled will keep indexers from syncing with the program entirely.
Note: tags are not yet functional
Note that if you're using a reverse proxy, you need to add the URL Base to this! If you do not, then when the indexers sync they will be broken, and if you've selected Add and Remove Only, it will not get fixed when you edit it!
Enter the URL of your program here. Again, enter the full URL Base if used.
Enter the API Key of your program here. You can get this from your program in the
General tab, and copy/paste it here.
Test your entry. If a green check-mark appears, you can save your entry, and repeat as necessary for each program you'd like to sync with Prowlarr. If it fails, you will need to check your log for the error (URL, API Key, etc.).
If you intend to do searches directly within Prowlarr, you need to add Download Clients. Otherwise, you do not need to add them here. For searches from your Apps, the download clients configured there are used instead.
Note: Prowlarr does not sync Download Clients to the Applications.
Download Clients, and then click the
+ to add a new download client. Your download client should already be configured to follow this guide.
Prowlarr supports integration with the following Usenet download clients:
And the following Torrent clients:
Select the download client you wish to add, and there will be a pop-up box to enter connection details. These details are similar for most clients. Some will ask for a username or password, some will ask for whether to add new downloads in a paused/start state, etc.
If this is an IP address or localhost, you DO NOT HAVE SSL. DO NOT CHECK THIS BOX.
Client priority only matters when 2 of the same type (usenet or torrent) are added. 1 is the highest priority, and if multiple clients of the same type exist and have the same priority, Prowlarr will alternate between then.
Test your entry. If a green check-mark appears, you can save your entry, and repeat as necessary for each download client you'd like Prowlarr to use. If it fails, you will need to check your log for the error (connection, credentials, etc.).
Connections are used for notifications from Prowlarr.
Connect, and then click the
+ to add a new connection.
There are many notification options available:
Each one has different configuration options. If you're using notifications within any of the Applications, these should be set up the same way.
Here is where you can maintain any existing tags you've used.
Tags. If you have any tags, they will appear here and you can delete them or edit them. If you have not applied tags anywhere in Prowlarr yet, this will show "no tags have been added yet" and there will be nothing to do in this page.
Note that tags are not yet functional in Prowlarr!
Here is where you will change generalized application settings such as port and logging level.
A lot of the options here can only be seen by clicking "Show Advanced" at the top of the screen. Any menu items in orange are hidden.
*unless you need to change it.
localhostor an IP address, this should almost NEVER be checked.
This is secret and should not be shared with anyone. If it gets shared, you should regenerate it and update your apps.
The default log level is
Info. This is very basic logging. You can change it here for more detailed logging. Log files will rotate, so there is no danger of taking up too much space.
Infologging is the minimum logging level. Good for day-to-day operations, but not sufficient for reporting errors to the development team.
Debuglogging is a mid-range logging level. Good for some error resolution, but still not extremely detailed. Contains all Info level logging as well.
Tracelogging is extremely detailed, and what the Developers want when reporting errors. Due to the amount of logging done, a single log file may contain only a few minutes of logs. Contains all Debug and Info level logging as well.
Check the box to help the Prowlarr development team gather statistics on install types, version, browser, and other information so that they can prioritize development and fixes properly.
Select the development branch you would like to use here. (Advanced Option) Valid options are
nightly and possibly other temporary testing branches as the developer group determines.
master (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. Prowlarr does not yet have a stable release.
develop (Beta): This is the testing edge. Released after tested in nightly to ensure no immediate issues. New features and bug fixes released here first.
Warning: You may not be able to go back to
masterafter switching to this branch. On GitHub, this is a snapshot of the
developbranch at a point in time.
Warning: You may not be able to go back to
developafter switching to this branch. On GitHub, this is the
:nightlyto the end of your container tag depending on who makes your builds.
Manual backups are retained forever, stored in the same folder, and are named differently. It's always advised to make a backup manually before doing anything like updates or branch changes.