# Maintainerr

Maintainerr is an automation tool for self-hosted media stacks that removes stale or unwatched content. It is open source and self-hosted, installable on Docker Hub, Proxmox, TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/207/maintainerr

## Description

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 9 platforms: Unraid, TrueNAS, Proxmox.

## Health score

81/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 16 days ago)
- Popular: 67 (2,321 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 89 (no serious findings, 1 minor, CI, tests)

## Links

- Documentation: https://docs.maintainerr.info
- Docker Hub: https://hub.docker.com/r/maintainerr/maintainerr
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=maintainerr
- TrueNAS: https://apps.truenas.com/catalog/maintainerr/
- Unraid: https://ca.unraid.net/apps/maintainerr-1xx4p731yavcyj?q=Maintainerr
- Official website: https://maintainerr.info
- GitHub: https://github.com/maintainerr/maintainerr

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/207/maintainerr), the self-hosted and open-source app directory.