Overview

Automated Plex media cleanup with watch-based rules, smart exclusions, and “Leaving Soon” notifications via Radarr, Sonarr & Tautulli. The project has 274 GitHub stars and is licensed under MIT.

Key Features

Source: GitHub README

Smart Exclusions - Protect content by genre, actor, collection, streaming availability (JustWatch), Trakt lists, and more
Watch-Based Rules - Delete only unwatched content, or content not watched in X days
Multi-Instance Support - Manage multiple Radarr/Sonarr instances (regular + 4K libraries)
Dry Run Mode - Preview what would be deleted before enabling real deletions
Leaving Soon Collections - Warn users before content is removed with Plex collections and notifications
Built-in Scheduler - Runs on a schedule automatically (daily, weekly, or custom cron)

Getting Started

Source: GitHub README

services:
  deleterr:
    image: ghcr.io/rfsbraz/deleterr:latest
    container_name: deleterr
    environment:
      LOG_LEVEL: INFO
    volumes:
      - ./config:/config
    restart: unless-stopped

schedule:
  cron: "0 0 * * 0"  # Every Sunday at midnight (default)
  # cron: "0 3 * * *"  # Daily at 3 AM
  # cron: "0 0 * * 0,3"  # Sundays and Wednesdays at midnight

Normalized Features

Source: tool-features-normalized.json

docker, docker compose, rest api, scheduled tasks.

Deploy

Docker

Self-host with Docker Compose

Coolify

One-click via Coolify panel

Elestio

Managed hosting from $9/mo

PikaPods

Simple managed hosting

Features

Integrations & APIs

REST API

Automation & Workflows

Scheduled Tasks / Cron

Related Media & Streaming Tools

View all 334 →

Immich

95K

High-performance self-hosted photo and video management — automatic backup, ML-powered search, and a Google Photos-like experience on your own server.

media AGPL-3.0

Jellyfin

49K

The volunteer-built media solution that puts you in control of your media. Stream movies, shows, music, and photos to any device from your own server.

media GPL-2.0