Required Settings¶
These settings must be configured for cli_debrid to function. They are collected during onboarding and can be changed any time under Settings → Required Settings.
Debrid Provider¶
Debrid Providers is one ranked list. Add a row for each debrid service (Real-Debrid, AllDebrid, Premiumize, TorBox, Debrid-Link or HighWay) with its API key, drag rows to set the order, and use each row's Test button to check the key. The first row is your main provider. Leave the list empty for a Usenet-only setup.
Getting your API key
Go to real-debrid.com/apitoken while logged in.
Go to alldebrid.com/apikeys while logged in.
Go to premiumize.me/account and look for API Key.
Go to torbox.app/settings while logged in.
Go to debrid-link.com/webapp/apikey while logged in.
More than one provider¶
When the first provider can't deliver a release (rate limits, DMCA blocks, errors), cli_debrid tries the next one in the list. Deleting from your library removes each torrent from the provider that added it. With two or more providers, the Debrid Manager has a provider picker.
AllDebrid
AllDebrid can't say whether a release is cached without adding it to your account, and it has suspended accounts that add many releases without downloading them. cli_debrid limits AllDebrid cache checks to 150 an hour and 10 per item, removes the ones it doesn't use, and only asks AllDebrid when no provider higher in the list has the release cached. Put AllDebrid lower in the list if you have another provider.
More debrid options¶
| Setting | Description |
|---|---|
| Ffprobe All Debrid Additions | Before collecting a debrid file, open it with ffprobe to confirm it plays, on top of the normal checks. Catches broken files before they reach your library (in Plex mode, before Plex is told about them), but makes every addition slower. |
| Enable Debrid Naming | cli_mount only. Rename debrid entries in cli_mount's DFS mount to {title} ({year}) - {imdb-id} - {version} - (original) for movies and {title} ({year}) - SxxExx - {episode title} - {imdb-id} - {version} - (original) for episodes. Only the entry in cli_mount is renamed. Needs cli_mount configured as the Usenet provider (URL set). |
| ↳ Include Version In Debrid Naming | Add the version to the name. On by default. |
| ↳ Include Content Source In Debrid Naming | Add the content source's display name. Off by default. |
Plex / Jellyfin¶
| Setting | Description |
|---|---|
| Plex URL | Full URL to your Plex server, e.g. http://192.168.1.10:32400 |
| Plex Token | Your Plex authentication token |
| Shows Libraries | Comma-separated list of your TV library names or IDs, e.g. TV Shows,Anime or 2,4 |
| Movie Libraries | Comma-separated list of your movie library names or IDs, e.g. Movies,4K Movies or 1,3 |
Using library IDs
You can use either the library name or its numeric ID. To find the ID, open your Plex library in the browser — the source= value at the end of the URL is the library ID. For example, source=1 means the library ID is 1.
| Setting | Description |
|---|---|
| Update Plex On File Discovery | Tell Plex to scan as soon as a file is found on the mount. cli_debrid must be able to read the mount at the Mounted File Location. |
| Disable Plex Library Checks | A "local only" mode for third-party symlinking: cli_debrid confirms files using the Mounted File Location instead of asking Plex. With no location set, items are marked Collected as soon as they're added. |
Finding your Plex token¶
- Open Plex Web and browse to any media item
- Click the ... menu → Get Info → View XML
- In the URL bar, copy the value after
X-Plex-Token=
Full guide: Plex integration
Symlink mode required
Jellyfin and Emby do not support the Plex API. You must use Symlinked/Local file management mode. See File Management below.
| Setting | Description |
|---|---|
| Jellyfin/Emby URL | Full URL to your Jellyfin/Emby server, e.g. http://192.168.1.10:8096 |
| Jellyfin/Emby Token | Your Jellyfin/Emby API token |
| Shows Libraries | Comma-separated list of your TV library names |
| Movie Libraries | Comma-separated list of your movie library names |
Getting your Jellyfin API key¶
- In Jellyfin, go to Dashboard → API Keys
- Click + to create a new key
- Name it
cli_debridand copy the generated key
Full guide: Jellyfin integration
File Management¶
This is one of the most important settings.
cli_debrid uses the Plex API to track which files are in your library. Plex reads directly from your debrid mount.
- Plex only — does not work with Jellyfin or Emby
- No symlinks needed
- Plex must be able to read the mount path
Mounted File Location: Set to your mount path, e.g.:
- cli_mount:
/path/to/debrid/__all__ - Zurg:
/mnt/zurg/__all__ - Decypharr:
/mnt/decypharr/__all__
cli_debrid creates symlinks from the mount into an organised folder structure. Your media server scans the symlink folder.
- Works with Plex, Jellyfin, and Emby
- Required for Jellyfin and Emby
- Required on Windows (use Jellyfin — Plex doesn't support symlinks on Windows)
| Field | Value |
|---|---|
| Original files path | Your mount path (e.g. /path/to/debrid/__all__ for cli_mount, /mnt/zurg/__all__ for Zurg, /mnt/decypharr/__all__ for Decypharr) |
| Symlinked files path | Where organised symlinks go, e.g. /mnt/symlinks |
Volume mounts must match exactly
In symlink mode, cli_debrid creates symlinks that point to files inside the debrid mount. For these symlinks to resolve correctly, both cli_debrid and your media server containers must mount the debrid storage and symlink folder at identical paths.
For example, if cli_debrid has:
Then Plex/Jellyfin/Emby must have the exact same mappings: If the paths differ between containers, symlinks will appear as broken files in your media server.Symlinked/Local mode on Windows
Windows requires Developer Mode enabled for symlinks. Plex does NOT support symlinks on Windows — use Jellyfin instead.
More file management options¶
Symlink naming and folder options are under Library & Files → Symlink Settings.
| Setting | Description |
|---|---|
| File Collection Management | Plex or Symlinked/Local — the mode chosen above. On Windows, Symlinked/Local uses hardlinks instead of symlinks. |
| Media Server Type | plex or jellyfin — which server to notify about new symlinks. |
| Plex URL For Symlink / Plex Token For Symlink | The Plex server to scan after creating symlinks (symlink mode). |
| Scan Mount For External Adds | Regularly scan the original files path for content added outside cli_debrid (e.g. via DMM or your debrid provider's website) and import it — symlink it and trigger a scan. Use this if your mount has no library-update hook (cli_mount, Decypharr, plain rclone); Zurg users get this through Zurg's on_library_update. The first run only records what's already there, without importing it. |
Usenet Mount¶
Optional. Needed to download NZBs found by Newznab scrapers. Works alongside a debrid provider, or on its own (leave the debrid API key empty for a Usenet-only setup).
| Setting | Description |
|---|---|
| Enable Usenet Mount | Turn on Usenet support |
| Provider | Built-in mount (default for new installs), cli_mount, NzbDAV, or Zurg (Zurg 2.0's SABnzbd-compatible endpoint). The built-in mount runs inside cli_debrid: it has no URL or token, and its servers and settings are on the Mount page (Built-in mount) |
| Mount URL | Where cli_debrid reaches the mount, e.g. http://cli_mount:8282 for cli_mount or http://nzbdav:3000 for NzbDAV. Use the container name or host IP — not localhost, which inside the cli_debrid container points at cli_debrid itself. |
| API Token | Only if your provider has authentication enabled |
| Fallback Category | Rarely used. Leave empty for the provider's default. |
| cli_mount Data Path | cli_mount's data folder as seen inside the cli_debrid container, needed for the cli_mount database backups and tools on the Maintenance page. Add - /path/to/appdata/cli_mount:/climount_data to your cli_debrid volumes and set this to /climount_data. |
| Usenet Retention Days | Ignore NZB results older than this many days. Default 5000; 0 turns it off. |
| Disable NZB Season Packs | On by default — recommended. Skips NZB season packs (movies aren't affected). One missing article in a season pack fails the whole pack and the repair re-downloads the entire season; per-episode NZBs keep a bad file to one episode. |
| Ffprobe All NZBs | Before collecting an NZB file, open it with ffprobe to confirm it plays, on top of the missing-article health check. Catches broken files before they reach your library (in Plex mode, before Plex is told about them), but makes every addition slower. Requires ffprobe (included in the Docker image). |
| Enable NZB File Naming | Name NZB jobs as {title} ({year}) - {imdb-id} - {version} - (original) for movies and {title} ({year}) - SxxExx - {episode title} - {imdb-id} - {version} - (original) for episodes, instead of the raw release name. |
| ↳ Include Version in NZB Name | Add the version (e.g. Default, 4K Remux) to the name. On by default. |
| ↳ Include Content Source in NZB Name | Add the content source's display name. Off by default. |
Click Detect under the Provider to find the mount. It tries the usual container names, the Docker host and localhost on each backend's ports, and only counts a backend that answers its own handshake. It also finds cli_mount's data folder and NzbDAV/Zurg mounts. Results are suggestions: a field is only filled on its own when it's empty and there's exactly one match.
NzbDAV / Zurg only
| Setting | Description |
|---|---|
| Repair: Owned Categories | Comma-separated NzbDAV categories cli_debrid's repair tool may touch. NzbDAV's history is shared with other apps (e.g. Lidarr), so repair must never act on their entries. Leave empty to use the categories cli_debrid itself grabs into. |
| Repair: Exclude Categories | Categories the repair tool must always ignore — e.g. ones Radarr/Sonarr use on the same NzbDAV. |
nzbdav_category_map |
(config file only) Which categories to use and what they're called on your instance, as bucket=name pairs, e.g. movies=movies, shows=shows, fallback=__unplayable__. Omitted buckets fall back to their parent category. |
For a setup where everything is filled in for you, see cli_debrid and cli_mount in one stack. See cli_mount and Getting Started for the full setup. Switching between cli_mount and NzbDAV? See Usenet Migration.
Metadata Providers¶
| Setting | Default | Description |
|---|---|---|
| TMDB Api Key | — | Used for posters, Discover and release dates. Use the API Key, not the "API Read Access Token". Register at themoviedb.org and request a free key under Settings → API. |
| TMDB Certification Region | US |
Which country's age ratings to show (e.g. US: R, PG-13 · GB: 15, 12A) |
| TVDB Api Key | — | TVDB v4 key. When set, TVDB is used instead of Trakt for metadata; a TMDB key is still needed for full release dates. It also unlocks TVDB's other episode orders (DVD, absolute…), which a show can switch to from Show options on its library page. Get a key at thetvdb.com/api-information. |
Trakt is optional
cli_debrid doesn't need Trakt to start or run the queue. To use Trakt content sources, set it up under Tracking accounts.
