Deleterr
Deleterr automatically cleans up Plex media libraries by using Radarr, Sonarr, and Tautulli to identify files that match your criteria and delete them.
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
68/100 Good
- Maintained
- 98last commit 10 days ago
- Popular
- 51339 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- 208 GB minimum RAM, runs on ARM
- Security check
- 88no serious findings, 2 minor, CI, tests
Availability: platform listings confirmed today, links checked 36 days ago
- GitHub stars
- 339
- Open issues
- 20
- Last commit
- 2026-11-11
- Latest release
- v0.3.2
- License
- MIT
- Activity
- rising
Checked 10 days ago - source: GitHub (rfsbraz/deleterr)
Resources & Compatibility
Minimum requirements: 8 GB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Turn on dry run before trusting it Set dry_run: true in your config/settings.yaml so Deleterr previews what it would delete instead of deleting it. This matters because it is easy to point it at the wrong library or use rules that are too broad, and you do not want your media removed on the first run. source
- Create the config folder on the host Create a folder on your own machine or server and mount it to /config in Docker Compose, such as ./config:/config, before starting the container. If that folder does not exist, Docker can fail with a bind mount error and Deleterr will not start. source
- Set Plex and media app details Fill in your Plex URL and token, plus the URLs and API keys for apps like Radarr or Sonarr. Without these, Deleterr cannot check your watch history or talk to your media apps, so it will not know what is safe to remove. source
Fetched 38 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What criteria can Deleterr use to choose files for deletion?
It can use watch history, age, and streaming availability. It relies on Radarr, Sonarr, and Tautulli to identify the media files.
Can Deleterr be set to run automatically?
It is described as automated Plex media cleanup. You can schedule it to delete files that match the configured criteria.
Does Deleterr specifically remove inactive media?
The creator made it to prune unwatched and inactive media. It was motivated by hitting storage limits and needing to free space.
Can it be customized per library or instance?
Yes, it supports metadata-based rules for different libraries and Sonarr/Radarr instances.
Answers sourced from github.com, www.reddit.com
Community
- r/selfhosted on Reddit: I created a tool to remove inactive media from ... (reddit)
- [deleted by user] : r/selfhosted - Reddit (reddit)
- Cross platform gallery management (with delete) : r/selfhosted - Reddit (reddit)
Collected 53 days ago - public community threads