Name: cli_debrid
Availability: InStock
Author: godver3

GitHub Website

DockerCompose file & guide

$ docker compose up -d

Support

Updated8 hours ago

LanguagePython

Setup difficultyAdvanced

Stars: 193
Ports: 5000 (Main web UI and API), 5001 (HTTPS / alternate access), 8888 (Additional port (purpose not documented))
Requires: Debrid mount (cli_mount, Decypharr, or Zurg+rclone), Media server (Plex, Jellyfin, or Emby)

Docker

godver3/cli_debrid

Dashboard showing library totals, what's airing, and recently added or upgraded items

Discover page for browsing trending titles, recommendations, and lists with one-click requests

Database browser showing every tracked movie and episode with filters, saved presets, and bulk actions

Queues view showing wanted, unreleased, collected, and blacklisted items

What is cli_debrid?

cli_debrid is a self-hosted media automation tool that monitors watchlists, searches torrent and Usenet indexers for releases matching quality profiles, sends them to debrid services or Usenet providers, streams files via a mount without local downloads, and organizes them into Plex, Jellyfin, or Emby libraries. It continuously upgrades content to better quality, repairs broken files, handles anime absolute numbering and episode orders, and provides a web UI with dashboard, library browser, calendar, upgrade hub, debrid manager, task manager, multi-user roles with SSO support, AI chat assistant, and notifications via Discord, Telegram, NTFY, and Email. Runs in Docker on AMD64/ARM64 and requires a debrid mount plus a media server.

Should you self-host cli_debrid?

cli_debrid scores 39/100 on selfhost.directory (how scoring works) and ranks #121 of 142 in Media Management. It has 193 GitHub stars.

It shipped 21 stable releases in the past year. The latest, v0.7.76, came out on 27 October 2026. New versions land roughly every 3 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is written mostly in Python.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 472 stars). It scores higher overall, so compare the two before you pick. See cli_debrid vs Sonarr side by side.

Features

AI Butler via OpenClaw
Anime absolute numbering and episode order handling
Automated media scraping and downloading
Automatic Quality Upgrades
Automatic repair of broken files
Built-in subtitle downloading
Multiple debrid provider support
Multi-user with roles and SSO (Authentik, Authelia, OIDC)
Notifications (Discord, Telegram, NTFY, Email)
Plex and symlinked library modes
Plex extras (collections, smart collections, labels, box sets, poster overlays)
Quality-based release selection (Versions)
Scraper Tester for debugging release scoring
Usenet Support
Web interface with dashboard, library, discover, calendar, upgrade hub, debrid manager, statistics, task manager

FAQ

How do I fix 'Port 5000 already in use' error?

Change cli_debrid's port mapping in docker-compose.yml (e.g. "5080:5000") or stop the conflicting service. On macOS, disable AirPlay Receiver which uses port 5000.

What are the normal memory baselines for cli_debrid?

Normal baselines: ~280–300 MB cold start, ~350–400 MB warm idle. Use the Performance Dashboard to monitor RSS over time.

How do I set up Overseerr/Seerr integration?

Enable the Seerr content source, verify URL and API key, and set up a webhook in Seerr pointing to http://YOUR_CLI_DEBRID_IP:5000/webhook with Request Approved enabled for instant pickup.

How do I use uncached content?

In Settings → Version Settings → Other Scraping Settings, set Uncached Content Handling to Hybrid (tries cache first, falls back to uncached) or Full (always takes best result regardless of cache). Uncached downloads can take hours.

What do the queue states mean?

States include Wanted (waiting to be scraped), Scraping (actively searching), Adding (submitting to debrid), Checking (waiting for file at mount), Collected (in library), Sleeping (all torrents blacklisted), Unreleased (not yet released), Pending Uncached, and Upgrading.