# Deploy Cleanuparr with Easypanel

URL: /templates/cleanuparr

Cleanuparr is an advanced automated download manager for the Servarr ecosystem (Sonarr, Radarr, Lidarr, Readarr, Whisparr). It monitors and cleans up problematic downloads across qBittorrent, Transmission, Deluge, µTorrent, and rTorrent clients. Core features include a strike-based system for failed imports, stalled and slow downloads; automatic blocklist-based malware file detection and removal; auto-triggered replacement searches when downloads are removed; seeding duration and ratio cleanup; orphaned file detection with hardlink checking; proactive missing-content and quality-upgrade searching; and smart notifications for all events. All configuration and state are stored in a single /config volume — no external database is required.

## Installation notes

After deployment open the app URL. Create your Account. Configure your Sonarr, Radarr, and download client connections under Settings. All automation rules are managed from the web interface.

## Benefits

### Automated Download Cleanup

Automatically detects and removes stalled, slow, failed, or malware- flagged downloads across every major torrent client — no manual intervention needed.

### Servarr-Native Integration

Deeply integrates with Sonarr, Radarr, Lidarr, Readarr, and Whisparr; triggers replacement searches and blocklists entries directly through their APIs when a download is removed.

### No External Dependencies

Runs as a single container with an internal SQLite database. There is no separate database or cache service to maintain.

## Features

### Strike-Based Removal

Assigns strikes to failed imports, stalled downloads, and slow transfers. Removals are triggered only after a configurable strike threshold, reducing false positives.

### Blocklist File Detection

Scans download contents against a malware / unwanted-file blocklist and removes matching torrents before they import into your media library.

### Seeding Ratio and Duration Control

Removes torrents that have hit your configured seeding ratio or time limit, keeping your torrent client tidy after downloads complete.

### Orphaned File Detection

Identifies orphaned files in your download client — with optional hardlink checking — so disk space is reclaimed safely.

### Proactive Content Search

Periodically triggers Sonarr/Radarr searches for missing episodes or movies and queues quality upgrades without manual intervention.

### Smart Notifications

Sends per-event notifications (removals, strikes, blocklist hits) via webhooks, Discord, Apprise, and more.

## Configuration

- `appServiceName` (App Service Name, required): cleanuparr

- `appServiceImage` (App Service Image, required): ghcr.io/cleanuparr/cleanuparr:2.9.14

## Services

- cleanuparr: app (ghcr.io/cleanuparr/cleanuparr:2.9.14)

## Resources

- [GitHub](https://github.com/Cleanuparr/Cleanuparr)

- [Documentation](https://cleanuparr.github.io/Cleanuparr/)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/cleanuparr)