Janitorr

Janitorr is a self-hosted media cleanup tool that removes old and unwatched content from Radarr, Sonarr, Jellyseerr, and Jellyfin or Emby to keep your server…

  • Media Applications
  • Media Servers
  • Other
  • Tools & Utilities
Janitorr is a self-hosted media cleanup tool that removes old and unwatched content from Radarr, Sonarr, Jellyseerr, and Jellyfin or Emby to keep your server from running out of disk space.

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.

67/100 Good

Maintained
74last commit 63 days ago
Popular
58766 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

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

GitHub stars
766
Open issues
3
Last commit
2026-09-19
Latest release
v2.2.2
License
GPL-3.0
Activity
stale

Checked 7 days ago - source: GitHub (Schaka/janitorr)

Resources & Compatibility

Requirements not published yet.

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

First-install notes

  • Fill in the settings file first Before starting Janitorr, edit the YAML settings file to enable each app you use and set its address (URL) and secret code (API key), plus the folder paths for leaving-soon files. If these are missing or wrong, Janitorr can't talk to Sonarr, Radarr, Jellyfin, Seerr, or Bazarr, and cleanup won't work. source
  • Make all paths point to the same folders Use the same host or container paths in Janitorr and your media apps, for example the /data/media/leaving-soon folder shown in the docs. If the paths resolve differently, Janitorr may look in the wrong place, fail to move or delete files, or cause your media server to lose track of them. source
  • Test with dry-run before deleting Set application.dry-run to true in the YAML for your first run, so Janitorr shows what it would delete instead of actually deleting. This matters because once files are removed they are gone, and a wrong setting can delete media you meant to keep. source
  • Config Template Updates Before updating, make sure your config file matches the latest config template in the GitHub repository. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What do I need to configure before starting Janitorr?

Enable each app in the YAML settings and provide its URL and API key, plus the leaving-soon folder paths. If these are missing or wrong, cleanup will not work.

Should I run Janitorr in dry-run mode before deleting media?

Yes, set application.dry-run to true for your first run so Janitorr shows what it would delete instead of deleting. Removed files are gone if you skip this check.

Do Janitorr paths need to match the paths used by my media apps?

Use the same host or container paths in Janitorr and your media apps, such as the /data/media/leaving-soon folder. If paths resolve differently, Janitorr may use the wrong location or cause your media server to lose track of files.

Can Janitorr use viewing stats from JellyStat?

Janitorr has optional JellyStat support. When enabled, file age is overwritten with the last active view from the JellyStat API.

Answers sourced from github.com, github.com, www.reddit.com

Community

Collected 49 days ago - public community threads