Reclaimarr

A tool to automatically reclaim disk space on your media server by intelligently deleting content from Jellyfin, Sonarr, and Radarr based on watch history and…

  • Automation
  • Media Applications
  • Media Servers
  • Other
  • Productivity
  • Tools & Utilities
A tool to automatically reclaim disk space on your media server by intelligently deleting content from Jellyfin, Sonarr, and Radarr based on watch history and age.

Platform availability

Available on 1 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 (not listed)

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.

45/100 Fair

Maintained
36last commit 368 days ago
Popular
3447 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
47
Open issues
8
Last commit
2025-11-18
Activity
stale

Checked 6 days ago - source: GitHub (Okhr/reclaimarr)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Deployment Reclaimarr runs as a long-running container with a built-in scheduler; add it to your existing media stack's docker-compose.yml. Configure API endpoints, keys, and deletion thresholds in a .env file, and use DRY_RUN mode to preview deletions before affecting your files. source
  • Preview deletions before enabling them Reclaimarr permanently deletes media files. On first run, set DRY_RUN=true in your .env file to preview exactly which files would be deleted without affecting them, and only switch to real deletions once you are confident in the results. source
  • Configuration Set the Jellyfin, Radarr, Sonarr, and Jellystat API endpoints and keys, plus the target disk-usage percentage, in a .env file. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I add Reclaimarr to an existing media stack?

Add the Reclaimarr service to your stack's Docker Compose file and set the Jellyfin, Jellystat, Jellyseerr, Radarr, and Sonarr API URLs and keys in environment variables. You also need to set MEDIA_PATH and mount the corresponding host media path.

What host path should I mount for Reclaimarr?

Mount your media library to /media inside the container, for example /srv/media:/media. The mounted path must match the path used by your other media services.

How can I preview what Reclaimarr will delete?

Set DRY_RUN=true so Reclaimarr can preview deletions without affecting your files.

How do I make Reclaimarr run automatically on a schedule?

Set CRON_SCHEDULE to a cron expression, such as "0 3 * * *" to run daily at 3 AM. If CRON_SCHEDULE is blank, the script runs once and exits cleanly.

How do I control when media becomes eligible for deletion?

Set TARGET_USAGE to keep disk usage below a target percentage and MIN_AGE_DAYS to require media to be older than a set number of days.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads