Home > Software > How to Streamline Your Media Management with Prowlarr: A Docker Compose Deployment Guide

How to Streamline Your Media Management with Prowlarr: A Docker Compose Deployment Guide

Anastasios Antoniadis

Discover how to deploy Prowlarr with a simple Docker Compose example.

Docker (1)

Prowlarr is an essential tool for enthusiasts and professionals managing extensive media libraries. It integrates seamlessly with popular download clients and media server applications, simplifying finding and managing torrents and Usenet indexes. Deploying Prowlarr using Docker Compose enhances its efficiency and simplifies the process, ensuring a smooth setup and scalable solution for managing your media sources. This article will guide you through the steps to deploy Prowlarr using Docker Compose, including a practical example to kickstart your setup.


Before deploying, ensure you have Docker and Docker Compose installed on your system. These tools are pivotal for creating and managing the containerized environment that Prowlarr will run in.

Step 1: Setting Up Your Docker Compose File

Begin by creating a directory dedicated to your Prowlarr setup. Within this directory, create a file named docker-compose.yml. This file will define the Prowlarr service, alongside any other services you wish to run in conjunction with it (e.g., media servers or download clients).

Docker Compose Example for Prowlarr

Below is a Docker Compose file tailored for deploying Prowlarr. This setup assumes you’re running it independently or alongside other services in your media management ecosystem.

version: '3.3'

    image: lscr.io/linuxserver/prowlarr:latest
    container_name: prowlarr
      - PUID=1000 # User ID
      - PGID=1000 # Group ID
      - TZ=Europe/London # Specify your timezone
      - ./prowlarr:/config # Prowlarr configuration files
      - ./data:/data # Where Prowlarr stores data
      - "9696:9696" # Expose port 9696 for web interface access
    restart: unless-stopped

Explanation of the Docker Compose File

  • Image: Specifies the Prowlarr Docker image to use, pulling the latest version from the LinuxServer repository, which is known for maintaining up-to-date and secure Docker images for various applications.
  • Container Name: An identifiable name for your container, making it easier to manage.
  • Environment Variables:
    • PUID and PGID: Ensures file permissions are correctly set in the container by matching your user/group ID.
    • TZ: Sets the timezone for correct time logging.
  • Volumes:
    • Configuration and data directories are mapped from the host to the container, ensuring your settings and data persist across container restarts.
  • Ports: Maps port 9696 from the container to the host, allowing you to access Prowlarr’s web interface.
  • Restart Policy: Ensures Prowlarr automatically restarts unless explicitly stopped, enhancing reliability.

Step 2: Launching Prowlarr

With your docker-compose.yml file configured, deploy Prowlarr by running the following command in the directory containing your Docker Compose file:

docker compose up -d

This command starts Prowlarr in detached mode, running quietly in the background.

Step 3: Accessing Prowlarr

Once Prowlarr is up and running, access its web interface by navigating to http://localhost:9696 on your preferred web browser. You’ll be greeted by the Prowlarr setup wizard, who will guide you through configuring your indexes and integrating them with your download clients and media servers.

Prowlarr Set Up Screen (1)


Deploying Prowlarr with Docker Compose offers a streamlined and efficient method to enhance your media management workflow. This guide provides a foundational understanding and a practical example to get you started with Prowlarr, ensuring a flexible and scalable media-sourcing solution. Docker Compose simplifies the deployment process and facilitates easy management and scalability of your media management tools, allowing you to focus more on enjoying your media collection and less on managing it.

Anastasios Antoniadis
Follow me
5 1 vote
Article Rating
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x