# Keeparr

Keeparr is a self-hosted web app that helps your whole household decide which media to keep on a Plex, Jellyfin, or Emby server, reports what can be safely deleted to reclaim disk space, and never deletes anything. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2955/keeparr

## Description

Keeparr is a self-hosted web app that helps your whole household decide which media to keep on a Plex, Jellyfin, or Emby server, reports what can be safely deleted to reclaim disk space, and never deletes anything itself.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

51/100 (Fair), based on 3 of 4 factors.
- Maintained: 84 (last commit 15 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/keeparr-1tv5d6l1d72inl?q=keeparr

## Common questions

### How do I control sign-in and admin access in Keeparr?

Users sign in with their media server account, and the first user to log in becomes the Owner. The Owner can turn off Open sign-in, enable or import users from Plex, and promote or revoke admin. The Owner cannot be demoted or disabled, so you cannot get locked out.

### Does Keeparr delete media from the server?

No, Keeparr never deletes anything. It only tags items and reports what can be reclaimed; deletion must be done manually in Plex, Jellyfin, Emby, Sonarr, or Radarr.

### What happens when multiple household members keep or ignore the same title?

Keeps are per-user but protective, so an item stays safe if any user keeps it. A user can remove only their own keep, and a person cannot have both keep and don't care for the same item.

### How can scripts read the reclaimable report or trigger refresh jobs?

Generate an API key in Settings and send it as X-Api-Key. This allows reading the stats or reclaimable report and triggering refresh jobs without logging in.

### Which media libraries does Keeparr track by default?

It tracks all Plex libraries by default. Untick any library in Settings to exclude it from Keeparr.

### How do I install Keeparr on Unraid?

Install it from the Unraid Community Apps store using the Keeparr template, then open the web UI and sign in with your Plex, Jellyfin, or Emby account.

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