Prunerr

Intelligent media library cleanup for Plex, Sonarr, and Radarr

Wiki • Install • API • Unraid Forum

---

If you run a Plex server, you know the pain. Your library keeps growing, nobody watches half of it, and you're constantly running out of disk space. Prunerr sits between your Plex server and your *arr apps and figures out what's worth keeping.

You set up rules like "delete movies nobody's watched in 6 months that are over 20GB" and Prunerr handles the rest. Everything goes through a deletion queue first, so nothing gets removed without you knowing about it.

Features

• Rules Engine — 28 condition fields across quality, ratings, watch history, collections, and metadata. Three ways to build rules: templates, natural language, or a full nested condition editor with live preview. More →

• Collections — Syncs movie collections from Radarr. Protect entire collections to prevent cleanup, or queue them for bulk deletion. More →

• Smart Deletion — Grace periods, four deletion actions (unmonitor, delete files, full removal, etc.), Overseerr request resets, and a review queue. Nothing gets deleted without your say-so. More →

• Dashboard — Library stats, storage trends, service health monitoring, upcoming deletions, and recommendations at a glance.

• Per-User Watch History — Integrates with Tautulli or Tracearr to track who watched what. Build rules around specific users' watching habits.

• API — Full REST API with key authentication for scripts, automation, and mobile apps like nzb360. More →

Quick Start

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

Also available via Docker Compose and the Unraid Community Apps store. See the Installation guide for full details.

Integrations

Service	Purpose	Required
Plex	Media server — library data, watch status	Yes
Sonarr	TV show management	Recommended
Radarr	Movie management, collections	Recommended
Tautulli / Tracearr	Per-user watch history	One required
Overseerr / Seerr	Request management	Optional
Unraid	Server monitoring	Optional
Discord	Notifications	Optional

Mobile

Prunerr works as a custom web app in nzb360 on Android, or in any mobile browser. The UI is fully responsive. See the Mobile Access guide.

Documentation

Full docs are in the Wiki:

• Installation — Docker, Compose, Unraid
• Configuration — Environment variables and service connections
• Rules Engine — Building and managing rules
• Collections — Protection and bulk actions
• Deletion Management — Queue, grace periods, actions
• API Reference — Endpoints and authentication
• Troubleshooting — Common issues

Support

• Unraid Forum: Support Thread
• GitHub Issues: Report a Bug
• Docker Hub: helliott20/prunerr

License

MIT License. See LICENSE.