This guide should be used to get configured and running with the basics, and to give you an understanding of how the pieces work together.
The first thing to set up in Prowlarr is indexers. You will add each indexer individually to Prowlarr.
Indexers, and then click the
+ to add a new indexer.
All indexers you can add (usenet and torrent) are listed, and you can type to partially match any existing entry. If the indexer you want to add doesn't exist in the list, you can add "Generic Newznab" (for usenet) or "Generic Torznab" (for torrents).
Some indexers have special settings, but most are standard as shown.
Test your entry. If a green check-mark appears, you can save your entry, and repeat as necessary for each indexer you'd like Prowlarr to use. If it fails, you will need to check your log for the error (URL, API Key, etc.).
After you've added your indexers, we then connect Prowlarr to your other *arr programs.
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.
Prowlarr currently supports the addition of these apps:
When you add an app, you will need to enter values in the pop-up screen:
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 Settings / 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.).
When you save this, it's going to sync your indexers to the app. They are all added with the Name you've chosen plus (Prowlarr) after it.
You should then go into your program, and disable the non-Prowlarr version of the indexer. Once everything is running smoothly, you can delete those entries and leave just the (Prowlarr) versions in place.
You should also go into your programs and check the categories for the Prowlarr indexers. Categories are not currently editable in Prowlarr, but are pushed over from a capabilities check.
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.
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.).
That's it for the basics! You can then add notifications and other more advanced setup options as needed. Those are documented in the full Settings page.