Skip to content

Installation

Jump to bottom
Harry Elliott edited this page Apr 6, 2026 · 1 revision

Installation

Docker

Easiest way to get going:

docker run -d \
  --name prunerr \
  -p 3000:3000 \
  -v /path/to/data:/app/data \
  -e PLEX_URL=http://your-plex-server:32400 \
  -e PLEX_TOKEN=your-plex-token \
  -e SONARR_URL=http://your-sonarr:8989 \
  -e SONARR_API_KEY=your-sonarr-api-key \
  -e RADARR_URL=http://your-radarr:7878 \
  -e RADARR_API_KEY=your-radarr-api-key \
  helliott20/prunerr:latest

Docker Compose

If you run everything in compose (most people do):

services:
  prunerr:
    image: helliott20/prunerr:latest
    container_name: prunerr
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - PLEX_URL=http://plex:32400
      - PLEX_TOKEN=your-plex-token
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      # Watch history - you need at least one of these
      - TAUTULLI_URL=http://tautulli:8181
      - TAUTULLI_API_KEY=your-tautulli-api-key
      # Optional stuff
      - OVERSEERR_URL=http://overseerr:5055
      - OVERSEERR_API_KEY=your-overseerr-api-key
      - DISCORD_WEBHOOK_URL=your-discord-webhook
    restart: unless-stopped

Unraid

Prunerr is in the Community Apps store. Just search for Prunerr and hit install.

If you can't find it there, you can add it manually with this template URL:

https://raw.githubusercontent.com/helliott20/prunerr/main/my-prunerr.xml

Once it's running

  1. Open http://your-server:3000
  2. Head to Settings and hook up your services — Plex, Sonarr/Radarr, and a watch history provider (Tautulli or Tracearr)
  3. Hit Sync Library to pull everything in
  4. Go to Rules and create your first rule

Your API key is in Settings > API Key. You'll need it if you want to hit the API from scripts or add Prunerr to nzb360.

Data

Everything lives in /app/data inside the container (SQLite database). Map this to somewhere persistent or you'll lose your config when the container restarts.

Updating

Docker: docker pull helliott20/prunerr:latest then recreate the container.

Compose: docker compose pull && docker compose up -d

Unraid: Hit the update button in the Docker tab when it shows up.

Architecture

Images are built for amd64 and arm64, so it runs on regular servers, Raspberry Pi 4+, Synology, etc. Docker pulls the right one automatically.

Clone this wiki locally