Prowlarr Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki

Prowlarr Setup Guide

Introduction

Prowlarr is an indexer manager/proxy that integrates with various applications like Sonarr, Radarr, and others. It allows you to manage indexers for Usenet and BitTorrent trackers in one place.

Recommended Pre-Setup

Before setting up Prowlarr, consider deploying the following containers first to simplify integration and avoid jumping between configuration steps:

  • Transmission-OpenVPN (for Torrent downloading)

💡 Highly Recommended: Use a VPN
When downloading torrents, your IP address is exposed to the public, making you vulnerable to tracking, data collection, and potential legal issues. Using a VPN ensures your internet traffic is encrypted and anonymized, protecting your identity and preventing unwanted scrutiny. Setting up VPN provides an extra layer of security, keeping your torrenting activities private and secure.

These services work closely with Sonarr, and having them set up beforehand streamlines the process.

Prerequisites

  • Docker installed
  • Prowlarr container running in your Docker stack

Configuration Steps

Step 1: Accessing the Prowlarr UI

  1. Open your browser and navigate to http://<your-ip-address>:9696.
  2. Upon first logon you will be asked to setup Authentication

**⚠️ Hint: You can disable Authentication, I would only recommend if you are using some other authentication method. edit config.xml and replace <AuthenticationMethod>Basic</AuthenticationMethod> with <AuthenticationMethod>External</AuthenticationMethod>

  • Set Authentication Method Basic
  • Username <Choose a username>
  • Password <Choose a password>
  • Save

Prowlarr Auth Setup

Step 2: Setting Up Indexers

  1. Open Prowlarr and navigate to the Indexers page. Select Add New Indexer.

  2. Apply the following filter preferences to optimize your search results: These settings help streamline the indexer setup process based on personal usage preferences.

    • Protocol: Torrent – I use Prowlarr exclusively for torrents and rely on Sabnzbd for Usenet downloads.
    • Language: en-US – English is my primary language, so I filter results accordingly.
    • Privacy: Public – I prefer free, public torrent indexers and allocate my budget for Usenet subscriptions.
  3. Select the Indexer you wish to add. The Add Indexer page will appear. Usually, the default settings work fine. Click Test to ensure the indexer is functional. If the test is successful, click Save.

    💡 Important Note: Avoid using indexers like TheRARBG and Knaben, as they are currently distributing malicious downloads (Virus). Stay vigilant and prioritize safe indexers.

Prowlarr Indexer
Prowlarr Indexer1

  1. In the Add Indexer page

Prowlarr Indexer2

Step 4: Adding Applications

  1. Navigate to the Settings blade, and underneath you will find Apps.
  2. Click +, and than add a service you wish

Prowlarr Apps1 Prowlarr Apps2

  1. Adding Applications in Prowlarr

    When the Add Application - screen appears, configure the following settings:

    • Name: Choose a friendly service name—this can be anything you prefer.
    • Sync Level: Full Sync – Ensures services like Sonarr and Radarr are updated whenever new indexers are added.
    • Prowlarr Server: The address of your Prowlarr server. Select one of the following options based on your setup:
      • http://prowlarr.example:9696
      • http://localhost:9696
      • http://prowlarr:9696
      • http://<Host IP>:9696
      • http://<Container IP>:9696
    • Server: The address of your service (Sonarr, Radarr) server. Choose the appropriate option based on your setup:
      • http://sonarr.example:8989
      • http://localhost:8989
      • http://prowlarr:8989
      • http://<Host IP>:8989
      • http://<Container IP>:8989
    • API Key: The API Key for the service you're connecting to. Find this in the service's webpage under Settings > General > API Key, then copy and paste it into Prowlarr. Also, add it to your .env file, as other containers will require it.

    💡 Preferred Address: If you’re using my Docker Git repository, I recommend following the <service>.example format (e.g., sonarr. <hostname>). This ensures consistent naming across services and prevents reliance on dynamic IP addresses.

Prowlarr Appsonarr Prowlarr Apikey

  1. Verify Prowlarr is pushing the indexers to the service you configured
    • go to the service home page, Settings, Indexers

Sonarr indexers

Step 5: Configuring Download Clients

  1. Go to the Settings tab.
  2. Click +.
  3. Choose the download client you have setup.

Prowlarr Clients

  1. Add the Download Client
  • Name: Choose a friendly service name—this can be anything you prefer.
  • Enable: checked - this will enable the client
  • Prowlarr Server: The address of your Prowlarr server. Select one of the following options based on your setup:

Prowlarr Clients2

  1. Click Test to ensure the Client is functional. If the test is successful, click Save.

Step 6: Setting Up Notifications

  1. Navigate to the Notifications tab.
  2. Click Add Notification.
  3. Configure your preferred notification methods (e.g., Discord, Email).
  4. Click Save.

Notes

  • Ensure all paths and environment variables are updated in the prowlarr.yaml file.
  • Regularly backup your config directory to save your settings.

Troubleshooting

  • Logs: Check Prowlarr logs for error messages.
  • Support: Discord
⚠️ **GitHub.com Fallback** ⚠️