← Directory

Maintainerr

Maintainerr is an automation tool for self-hosted media stacks that removes stale or unwatched content.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Maintainerr is an automation tool for self-hosted media stacks that removes stale or unwatched content. It applies user-defined rules, moves flagged movies and shows to a review collection, waits for a grace period, and then deletes them from your media server, media managers, and request tool. It is useful for Jellyfin, Emby, Plex, Radarr, Sonarr, and Seerr users. Use Maintainerr to stop abandoned requests and unwatched items from filling your storage.

Platform availability

Available on 3 of 6 install platforms

Also on Docker Hub and GitHub

Health score

80/100 Excellent

Maintained
100last commit 7 days ago
Popular
672,303 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

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). Factors without data are left out and the rest are rescaled.

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

GitHub stars
2,303
Open issues
2
Last commit
2026-09-28
Latest release
v3.29.0
License
MIT
Activity
declining

Checked 7 days ago - source: GitHub (Maintainerr/Maintainerr)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

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

First-install notes

  • Use the Docker command and keep data Run the provided docker run command, make sure the -v ./data:/opt/data line is included, and note that the app is reached through port 6246, the number you add to your server's address in a browser. That data folder stores your settings and library information, so if you skip it, your setup can be lost when the container is recreated. source

Fetched 7 days ago - each note links to its source

Alternatives (1)

  • Janitorr - Janitorr is a self-hosted media cleanup tool that removes old and unwatched content from Radarr, Sonarr, Jellyseerr, and Jellyfin or Emby tâ€Ĥ

Checked 4 days ago - source: AlternativeTo

Common questions

What persistent volume should I mount for Maintainerr, and why is it important?

Mount a host folder to /opt/data inside the container. It stores settings and library information, so skipping it can lose your setup when the container is recreated.

How do I run Maintainerr from a subdirectory?

Set the BASE_PATH environment variable and include that path at the start of API endpoints, such as /maintainerr/api/health/ready.

Why are image features missing on an older x86-64 VM?

Overlay and collection poster features use sharp, which requires an x86-64-v2 CPU. Maintainerr still starts on older CPUs, but those features are disabled unless the VM CPU type is set to host, x86-64-v2, or newer.

How can Maintainerr clean leftover files from the media folder?

Mount the media library into the container at the same path that Radarr or Sonarr reports it at. The leftover-folder cleanup then uses that mount.

How do I turn off Maintainerr's anonymous usage reporting?

Set the TELEMETRY environment variable to off.

Answers sourced from github.com, github.com

Community

Collected 2 days ago - public community threads