Docker Compose

This guide will show you how to run Reaparr with Docker on any OS (Linux, Windows, macOS). Follow the steps to get Reaparr up and running in a Docker container.

Reaparr Image on Docker Hub

Prerequisites

Have Docker installed on your system. The guides assume you already have Docker set up.

1) Create data directories on the host

You need these directories on your host. They will be mounted into the container:

/Config – Configuration, logs, and database (SSD recommended)
/Downloads – Temporary storage during downloads
/Movies – Default movies destination folder
/TvShows – Default TV-show destination folder

Example (home directory) on Linux/macOS:

mkdir -p ~/Reaparr/Config ~/Reaparr/Downloads ~/Reaparr/Movies ~/Reaparr/TvShows

2) Find your user’s PUID and PGID

Run this command in a terminal to find your user’s UID and GID:

id

Example output:

uid=1000(user) gid=1000(user) ...

uid=1000 → PUID=1000
gid=1000 → PGID=1000

More info: https://docs.linuxserver.io/general/understanding-puid-and-pgid/

3) Run Reaparr with Docker

Option A: docker run

Customize paths, timezone, and IDs to match your system:

docker run -d \
  --name Reaparr \
  -p 7000:7000 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=America/New_York \
  -v <ADD_FOLDER_PATH>/Config:/Config \
  -v <ADD_FOLDER_PATH>/Downloads:/Downloads \
  -v <ADD_FOLDER_PATH>/Movies:/Movies \
  -v <ADD_FOLDER_PATH>/TvShows:/TvShows \
  reaparr/reaparr:latest

Option B: Docker Compose

Reference compose file: docker-compose.yml

Download the example to ~/Reaparr:

curl -o ~/Reaparr/docker-compose.yml https://raw.githubusercontent.com/Reaparr/Reaparr/refs/heads/dev/docker/docker-compose.yml

Adjust values as needed (paths, PUID, PGID, TZ):

version: '3.4'
services:
  reaparr:
    container_name: Reaparr
    image: reaparr/reaparr:latest
    build:
      context: .
      dockerfile: ./Dockerfile
    ports:
      # Web UI & Web API
      - '7000:7000'
    restart: unless-stopped
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
      - UNMASKED=false # Unmask sensitive data in logs if true
      # - LOG_LEVEL=DEBUG # Set the logging level in the docker logging
    volumes:
      # Example host paths – replace with valid writable locations on your machine
      - /mnt/PROJECTS/ReaparrCache/Config:/Config
      - /mnt/PROJECTS/ReaparrCache/Downloads:/Downloads
      - /mnt/PROJECTS/ReaparrCache/Movies:/Movies
      - /mnt/PROJECTS/ReaparrCache/TvShows:/TvShows

Bring it up:

docker-compose -f ~/Reaparr/docker-compose.yml up -d

4) Verify and access

Check the container:

docker ps

5) Done!

Continue with the Reaparr setup guide to connect your Plex account and configure your settings."

Troubleshooting

Docker command not found or fails to start: ensure Docker is installed and the service/daemon is running
Cannot access Reaparr Web UI:
- Verify the container is running (docker ps)
- Check firewall rules for port 7000
- Try a different browser
Permission errors (e.g., UnauthorizedAccessException on /Config/ReaparrSettings.json):
- Ensure PUID and PGID match your user
- Ensure your user has write permission for the mounted host folders

Edit this page or Report an issue

Getting started

This guide will help you get Reaparr up and running on your system. Follow the instructions for your platform to install and configure Reaparr, and start downloading media from your Plex servers in no time!

Unraid

This guide will walk you through the steps to install Reaparr on Unraid using the Community Applications plugin.