Self-host deleterr
v0.3.0Plex library cleanup using watch history and smart rules
- Stars
- 341
- Requires
- Plex Media Server, Tautulli
ghcr.io/rfsbraz/deleterrWhat is deleterr?
Deleterr is a self-hosted Python application that automates Plex media library cleanup. It connects to Plex, Tautulli, Radarr, and Sonarr to analyze watch history and metadata, then removes media files matching user-defined criteria such as watch status, age, and streaming availability. Key capabilities include smart exclusions by genre, actor, collection, Trakt or MDBList lists, and JustWatch streaming availability; watch-based rules; multi-instance support for separate 4K libraries; a dry-run mode for safe testing; and a signature Leaving Soon feature that tags content for a grace period before deletion while notifying users through multiple channels. It runs as a Docker container with a built-in scheduler or can be triggered externally via Ofelia. Configuration is done through a single YAML file. The project is MIT-licensed and actively maintained.
Should you self-host deleterr?
deleterr scores 50/100 on selfhost.directory (how scoring works) and ranks #68 of 142 in Media Management. It has 341 GitHub stars.
It shipped 18 stable releases in the past year. The latest, v0.3.0, came out on 26 October 2026. New versions land roughly every 6 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is Janitorr (53/100, 762 stars). It scores higher overall, so compare the two before you pick. See deleterr vs Janitorr side by side.
Features
- Built-in scheduler
- Disk Thresholds
- Dry Run Mode
- Emergency cleanup (--free-up)
- JustWatch streaming availability exclusions
- Leaving Soon Collections
- MDBList exclusions
- Multi-Instance Support
- Seerr/Overseerr request-based exclusions
- Smart exclusions
- Sorting & prioritization
- Trakt list exclusions
- User Notifications
- Watch-based deletion rules
- YAML Configuration
deleterr README
More in Plex
KitanaKitana is a self-hosted, open-source web frontend that exposes Plex plugin interfaces via Plex.TV authentication, making them manageable from mobile devices.
OmbiSelf-hosted, open-source media request tool: Plex, Emby and Jellyfin users request movies, TV and music, which get approved and handed to Sonarr or Radarr.
pastaSelf-hosted, browser-based Plex helper to batch-change audio and subtitle tracks for whole TV shows or single episodes, with Docker image and Unraid template.
CleanarrCleanarr is a self-hosted, open-source web UI that helps Plex users find and delete duplicate media files and sample files from their Plex libraries.
0 comments