How to Install Prowlarr with Docker Compose (Step-by-Step Video)

Prowlarr logo with the words install with Docker Compose, step by step

For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer

Updated 16 November 2026 Tested with: Prowlarr 2.6.5

Prowlarr keeps all your indexers in one place. You add each indexer once, in Prowlarr, and it shares it with Radarr, Sonarr and your other apps automatically. When those apps search, Prowlarr searches every indexer at once and sends the results back.

This guide installs Prowlarr with Docker Compose in six short steps: install it, add an indexer, test a search and connect it to Radarr. Watch the video first, then follow the written steps underneath. It takes about 10 minutes.

On this page (12 sections)

Watch: install Prowlarr with Docker Compose

The video has subtitles at the bottom and no sound. It was recorded on a clean test install, so your addresses and passwords will be different.

What you need

  • A computer or NAS running Docker. New to Docker? The Docker install guide covers Windows, Mac and Linux.
  • About 200 MB of disk space for Prowlarr’s settings.
  • Later: Radarr or Sonarr, if you want Prowlarr to feed them.

Use it legally. Prowlarr is a search tool. It doesn’t come with any indexers, and what you search for is up to you. Only add indexers you have a legitimate account with, and only download media you own or have the right to use. Downloading copyrighted material without permission is illegal in the UK and most other countries.

The Docker Compose file

This is the whole compose file. It’s the same one used in the video.

services:
  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    container_name: prowlarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - ./config:/config
    ports:
      - 9696:9696
    restart: unless-stopped
Line What it does Change it?
image The Prowlarr image from LinuxServer.io No
PUID / PGID The user and group Prowlarr runs as, so its files belong to you Yes: use the numbers from id (Step 1)
TZ Your time zone, for log times and schedules Yes, for example Europe/London or America/New_York
./config:/config Keeps Prowlarr’s settings in a config folder next to the compose file Only if you keep app settings somewhere else
9696:9696 The port you open Prowlarr on Only the left number, if 9696 is already in use
restart Starts Prowlarr again after a reboot No

Step 1: Make a folder and find your PUID and PGID

Open a terminal on your server (or SSH into it) and run:

mkdir -p ~/prowlarr && cd ~/prowlarr
id

id shows something like uid=1000(user) gid=1000(user). The uid number is your PUID and the gid number is your PGID.

Step 2: Create the compose file

nano compose.yaml

Paste in the compose file from above and change PUID, PGID and TZ to match yours. Press Ctrl+O and Enter to save, then Ctrl+X to exit.

Step 3: Start Prowlarr

docker compose up -d
docker compose ps

Docker downloads Prowlarr the first time. When docker compose ps shows Up in the STATUS column, it’s running.

Step 4: Set up your login

Open http://YOUR-SERVER-IP:9696 in a web browser. The first time, Prowlarr asks you to set up a login:

  1. Authentication Method: Forms (Login Page)
  2. Authentication Required: Enabled
  3. Choose a username and a strong password, type the password again, and click Save.
  4. Reload the page and sign in with the details you just chose.

You land on the Indexers page, which is empty for now.

An indexer is a site that lists downloads. Prowlarr doesn’t come with any, so you add the ones you want. The video uses the Internet Archive, a non-profit library of free and public-domain books, films, music and software, so you can try it straight away without an account.

  1. On the Indexers page, click Add Indexer.
  2. Type the name in the search box at the top, for example Internet Archive, and click it in the list.
  3. Leave the settings as they are. Indexers that need an account ask for your API key or login here; you’ll find these in your account on the indexer’s website.
  4. Click Test. A green tick means Prowlarr can reach it. Then click Save and Close.

Now check it works. Click Search in the left menu, type debian and press Enter. Results from all your indexers appear in one list, here Debian Linux downloads from the Internet Archive. If you see results, Prowlarr is working. ๐ŸŽ‰

Usenet indexers work the same way: pick the indexer (or Generic Newznab if it isn’t listed), paste the API key from your account, then Test and Save. Only add indexers you have a legitimate account with.

Step 6: Connect Radarr and Sonarr

Once you’ve installed Radarr, connect it here and Prowlarr sends it every indexer you add:

  1. In Radarr, go to Settings โ†’ General and copy the API Key.
  2. In Prowlarr, go to Settings โ†’ Apps, click + and choose Radarr.
  3. Prowlarr Server: your server’s IP and port 9696, for example http://192.168.1.10:9696.
  4. Radarr Server: your server’s IP and port 7878, for example http://192.168.1.10:7878.
  5. Paste the API Key, click Test (you should get a green tick), then Save.

Do the same for Sonarr, on port 8989. Within a minute your indexers appear in Radarr and Sonarr under Settings โ†’ Indexers. Don’t edit them there, because Prowlarr manages them.

If something’s wrong

  • The page won’t open. Check docker compose ps says Up, and that you’re using the server’s IP address, not localhost, from another computer.
  • “Permission denied” in the logs. The config folder belongs to a different user. Run sudo chown -R 1000:1000 ~/prowlarr/config with your own PUID and PGID.
  • The Radarr test fails. Use the server’s IP address in both boxes, not localhost. Each app runs in its own container, so localhost means the container itself.
  • “Indexers are unavailable due to failures”. Prowlarr pauses an indexer for a while after errors. Once the site is working again, open the indexer and click Test to clear it.
  • You need the logs. Run docker compose logs --tail 100 prowlarr in the Prowlarr folder.

Updating Prowlarr

cd ~/prowlarr
docker compose pull && docker compose up -d

Frequently asked questions

What is Prowlarr?

Prowlarr keeps all your indexers in one place. You add each indexer once, and it shares them with Radarr, Sonarr and your other apps automatically, then searches them all at once when those apps ask.

Does Prowlarr come with any indexers?

No. Prowlarr is only a search tool. You add the indexers you want with Add Indexer. To try it without an account, add the Internet Archive and search for debian.

What port does Prowlarr use?

9696. Open http://YOUR-SERVER-IP:9696 in a web browser. To use a different port, change only the left number in the ports line of the compose file.

Why don't Radarr or Sonarr get the indexers?

Use your server's IP address, not localhost, in both the Prowlarr Server and the app's server fields. Each app runs in its own container, so localhost means the container itself.

How do I update Prowlarr?

In the Prowlarr folder, run docker compose pull and then docker compose up -d. Your settings stay in the config folder.

Thank you

Prowlarr is made by the Servarr team, the same people behind Radarr and Sonarr. It’s free and open source. Thanks also to LinuxServer.io for the Docker image this guide uses.

Next in this series: Radarr.

Related guides: Install Docker, Radarr, Sonarr.

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply