cli_mount¶
cli_mount is an all-in-one debrid client that handles torrent management, mounting, and symlink delivery in a single container. It replaces the Zurg + rclone stack and integrates directly with cli_debrid via a blackhole/symlink workflow.
cli_mount is a fork of Decypharr maintained by mash2k3, optimised for cli_debrid compatibility.
flowchart LR
A["Debrid cloud"] --> B["cli_mount\nDFS / rclone mount"]
B -->|"option 1\ndirect"| E["Media Server\nPlex / Jellyfin / Emby"]
B --> D["cli_debrid"]
D -->|"option 2\nsymlinks"| F["Symlinks"]
F --> E
D -->|"triggers scan"| E
Nothing is stored locally
cli_mount streams content directly from Real-Debrid. No files are downloaded to your server.
Prerequisites¶
- A paid debrid service account (e.g. Real-Debrid, AllDebrid, Torbox)
- Your debrid API token — found in your debrid provider's account settings
/dev/fuseavailable on the host (required for mounting)
Installation¶
Installing cli_debrid too? Use one compose file
The Docker guide has a single compose file that runs cli_mount and cli_debrid together, with the mount shared between them. It's the simplest setup on a Linux host.
services:
cli_mount:
image: ghcr.io/mash2k3/cli_mount:dev
container_name: cli_mount
restart: unless-stopped
network_mode: bridge
ports:
- "8282:8282/tcp"
volumes:
- /path/to/debrid:/mnt:rshared # (1)
- /path/to/cache:/cache:rw # (2)
- /path/to/appdata:/app:rw # (3)
devices:
- /dev/fuse:/dev/fuse:rwm
cap_add:
- SYS_ADMIN
security_opt:
- apparmor:unconfined
environment:
- TZ=America/New_York
- Host path where your debrid library will be mounted — point Plex and cli_debrid here
- Cache directory for rclone VFS or DFS chunk cache
- Config file, database, and downloads folder
Unraid users
Use the actual pool path for the mount volume (e.g. /path/to/cache/cli_mount), not the user share path. This avoids array startup issues.
docker create \
--name='cli_mount' \
--net='bridge' \
--pids-limit 2048 \
--privileged=true \
-e TZ="America/New_York" \
-p '8282:8282/tcp' \
-v '/path/to/debrid':'/mnt':'rw,shared' \
-v '/path/to/cache':'/cache':'rw' \
-v '/path/to/appdata':'/app':'rw' \
--device /dev/fuse:/dev/fuse:rwm \
--cap-add SYS_ADMIN \
--security-opt apparmor:unconfined \
ghcr.io/mash2k3/cli_mount:dev
docker start cli_mount
docker logs -f cli_mount
Unraid users
Use the actual pool path for the mount volume (e.g. /path/to/cache/cli_mount), not the user share path. This avoids array startup issues.
The simplest method — installs with a pre-configured template.
Step 1 — Open Community Applications
In the Unraid web UI, click the Apps tab.
Step 2 — Search for cli_mount
Type cli_mount in the search bar and press Enter.
Step 3 — Install the template
Click Install on the template by mash2k3.
Step 4 — Configure the template
Fill in the template fields:
| Field | Value |
|---|---|
| Port | 8282 (cli_mount's default) |
| rclone | Your debrid mount path (e.g. /path/to/debrid) → /mnt |
| cache | Your cache path (e.g. /path/to/cache) → /cache |
| config | Your appdata path (e.g. /path/to/appdata/cli_mount) → /app |
Use the :dev tag
The repository is ghcr.io/mash2k3/cli_mount:dev for the latest build. Check the releases page for stable tags.
Step 5 — Apply
Click Apply. Unraid pulls the image and starts the container.
Unraid users
Use the actual pool path for the mount volume (e.g. /path/to/cache/cli_mount), not the user share path. This avoids array startup issues.
Paste the same compose file from the Docker Compose tab into your stack editor and deploy.
- Portainer: Stacks → Add Stack → paste → Deploy
- Dockge: + Compose → paste → Deploy
- Dockhand: Stacks → + Create → paste → Create & Start
The binary method runs cli_mount as a process directly on your Linux host — no Docker required.
Step 1 — Create the appdata folder¶
Step 2 — Download cli_mount¶
- Go to cli_mount releases on GitHub
- Download the latest release for your platform:
- Linux x64:
cli_mount_Linux_x86_64.tar.gz - Linux ARM64:
cli_mount_Linux_arm64.tar.gz
- Linux x64:
- Extract the archive:
- Place the extracted binary in your appdata folder and make it executable:
Step 3 — Create config.json¶
Create a config.json in your appdata folder. The web UI at http://YOUR_SERVER_IP:8282 can also be used to generate this after first run — see Configuration below.
Step 4 — Start cli_mount¶
Run the binary, pointing it at your config file:
To run it as a background service, create a systemd unit:
[Unit]
Description=cli_mount debrid client
After=network.target
[Service]
WorkingDirectory=/home/YOUR_USER/cli_mount
ExecStart=/home/YOUR_USER/cli_mount/cli_mount --config /home/YOUR_USER/cli_mount/
Restart=always
[Install]
WantedBy=multi-user.target
Step 5 — Verify¶
Open the cli_mount web UI to confirm it is running and connected:
Run cli_mount as a binary on Unraid using User Scripts — useful if you prefer to avoid Docker or want tighter control over the process.
Step 1 — Create the appdata folder¶
Step 2 — Download cli_mount¶
- Go to cli_mount releases on GitHub
- Download the latest
cli_mount_Linux_x86_64.tar.gz - Extract the archive and place the
cli_mountbinary in your appdata folder:
tar -xzf cli_mount_Linux_x86_64.tar.gz
cp cli_mount /path/to/appdata/cli_mount/
chmod +x /path/to/appdata/cli_mount/cli_mount
Step 3 — Create config.json¶
Create a config.json in /path/to/appdata/cli_mount/. The web UI at http://YOUR_SERVER_IP:8282 can also be used to generate and edit settings after first run — see Configuration below.
Step 4 — Create User Scripts¶
Go to Settings → User Scripts and create the following scripts:
Script 1 — Start cli_mount (Schedule: At Startup of Array)
#!/bin/bash
chmod +x /path/to/appdata/cli_mount/cli_mount
/path/to/appdata/cli_mount/cli_mount --config /path/to/appdata/cli_mount/ &
Always use Run in Background
When running manually from User Scripts, always click RUN IN BACKGROUND.
Script 2 — Stop cli_mount (Schedule: At Stopping of Array)
This script is important
Without a stop script, stopping the array while cli_mount holds a FUSE mount can cause an unclean shutdown and trigger a parity check.
Step 5 — Verify¶
Open the cli_mount web UI to confirm it is running:
cli_mount has a native Windows binary — no Docker required.
Step 1 — Download cli_mount¶
- Go to cli_mount releases on GitHub
- Download the latest
cli_mount_Windows_x86_64.zip - Extract the zip and place
cli_mount.exein a permanent folder (e.g.C:\cli_mount\)
Step 2 — Create config.json¶
Create a config.json in the same folder. The web UI at http://localhost:8282 can also be used to generate and edit settings after first run — see Configuration below.
Step 3 — Run cli_mount¶
Open a terminal in the folder and run:
Step 4 — Run at startup (optional)¶
To start cli_mount automatically when Windows boots:
- Press
Win + R, typeshell:startup, press Enter - Create a shortcut to
cli_mount.exein the folder that opens, with--config C:\cli_mount\as the argument
Alternatively, use Task Scheduler to create a task that runs cli_mount.exe at logon with the config argument.
Step 5 — Verify¶
Open the cli_mount web UI to confirm it is running:
Configuration¶
cli_mount is configured via a config.json file placed in your appdata folder (/app inside the container). The web UI at http://YOUR_SERVER_IP:8282 can also be used to edit settings after first run.
Debrid provider¶
Add your Real-Debrid API key and tune the connection settings:
| Setting | Value | Description |
|---|---|---|
provider |
realdebrid |
Debrid provider name |
api_key |
YOUR_API_KEY |
Your Real-Debrid API token |
rate_limit |
250/minute |
Matches Real-Debrid's default API limit |
minimum_free_slot |
1 |
Minimum available download slots before queueing |
torrents_refresh_interval |
15s |
How often to poll Real-Debrid for torrent changes |
download_links_refresh_interval |
40m |
How often to refresh expiring download links |
workers |
600 |
Concurrent link-generation workers — suitable for large libraries |
auto_expire_links_after |
3d |
How long to cache links before forcing a refresh |
Mount mode¶
cli_mount supports two mount backends. Choose one:
DFS is cli_mount's native mount system — lighter than rclone with no separate binary required.
| Setting | Value | Description |
|---|---|---|
type |
dfs |
Selects the DFS mount backend |
mount_path |
/mnt |
Where the library is mounted inside the container |
cache_expiry |
24h |
How long file metadata is cached |
cache_dir |
/cache/dfs |
Where DFS stores its chunk cache |
disk_cache_size |
500MB |
Max cache size on disk |
chunk_size |
8MB |
Read chunk size — increase if experiencing stuttering |
read_ahead_size |
128MB |
How much to buffer ahead during playback |
uid / gid |
1000 / 1000 |
File ownership for the mount |
allow_other |
true |
Required so Plex can access the mount |
rclone mode uses an embedded rclone binary with a full VFS cache. More compatible but heavier on disk I/O.
| Setting | Value | Description |
|---|---|---|
type |
rclone |
Selects the rclone mount backend |
mount_path |
/mnt |
Where the library is mounted inside the container |
port |
5572 |
rclone RC API port |
cache_dir |
/cache |
VFS cache location |
vfs_cache_mode |
full |
Full VFS cache for best compatibility |
vfs_cache_max_age |
5h |
How long cached chunks are kept |
vfs_cache_max_size |
12G |
Maximum VFS cache size on disk |
vfs_read_chunk_size |
128M |
Initial read chunk size |
transfers |
6 |
Parallel download streams |
uid / gid |
1000 / 1000 |
File ownership for the mount |
no_checksum |
true |
Skips checksum verification for faster streaming |
Use this when managing the rclone mount yourself outside of cli_mount — for example via Unraid User Scripts. cli_mount exposes its library as a WebDAV source (cli_mount:) which rclone mounts to a local path.
Prerequisite
The rclone Unraid plugin must be installed to have the rclone and fusermount commands available. Install it from the Apps tab in the Unraid web UI.
Mount script (At Startup of Array)¶
#!/bin/bash
sleep 10 # (1)
rclone mount cli_mount: /path/to/debrid \
--dir-cache-time 20s \
--config=/path/to/appdata/cli_mount/rclone/rclone.conf \
--allow-other \
--allow-non-empty \
--gid 100 \
--uid 1000 \
--vfs-cache-mode full \
--vfs-cache-max-age 5h \
--vfs-cache-max-size 12G \
--cache-dir /path/to/cache/cli_mount \
--retries 0 \
--low-level-retries 0 \
--daemon
- Give cli_mount time to start up before rclone tries to connect
Always use Run in Background
When running this script manually from User Scripts, always click RUN IN BACKGROUND.
Unmount script (At Stopping of Array)¶
This script is critical
Without it, stopping the array while the FUSE mount is active causes a "Retry un-mounting disks" error and forces an unclean shutdown and parity check.
Adjust /path/to/debrid, the rclone.conf path, and --cache-dir to match your actual paths.
Combining with the cli_mount binary scripts
If you are also running cli_mount as a binary (see the Binary (Unraid) tab), you can combine these into the same User Scripts rather than maintaining separate ones. Start cli_mount first, add a sleep to give it time to initialise, then run the rclone mount. On shutdown, unmount rclone first, then stop cli_mount.
Combined startup script:
#!/bin/bash
# Start cli_mount
chmod +x /path/to/appdata/cli_mount/cli_mount
/path/to/appdata/cli_mount/cli_mount --config /path/to/appdata/cli_mount/ &
# Wait for cli_mount to initialise before mounting
sleep 15
# Mount with rclone
rclone mount cli_mount: /path/to/debrid \
--dir-cache-time 20s \
--config=/path/to/appdata/cli_mount/rclone/rclone.conf \
--allow-other \
--allow-non-empty \
--gid 100 \
--uid 1000 \
--vfs-cache-mode full \
--vfs-cache-max-age 5h \
--vfs-cache-max-size 12G \
--cache-dir /path/to/cache/cli_mount \
--retries 0 \
--low-level-retries 0 \
--daemon
Combined stop script:
Content routing¶
cli_mount can sort incoming torrents and NZBs into extra subfolders using custom_folders (shown as virtual folders in the UI). Each folder has regex filters that match against the release name and its file list. Everything is always available in __all__ as well.
Do you need content routing?
- Plex mode — yes. Plex reads the mount directly, so your Plex libraries need separate movie and TV folders to point at (e.g. a Movies library on
Movies/and a TV library onTV Shows/). - Symlink mode — optional. cli_debrid builds its own organised folder tree from
__all__, so routing isn't required. It's still handy for browsing the mount yourself, since movies and shows land in separate folders. See the symlink mode example below.
The filters below create a TV Shows and a Movies folder. You can name the folders whatever you like.
TV Shows¶
Add two filters to this folder:
regex
(?i)((?:^|[^a-z0-9])S[0-9]{1,4}(?:[ ._-]?E[0-9]{1,4}|E?(?:[^a-z0-9]|$))|(?:^|[^a-z0-9])[0-9]{1,2}E[0-9]{2,3}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])Ep[ .]?[0-9]{1,4}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])[0-9]{1,2}of[0-9]{1,2}(?:[^a-z0-9]|$)|Series[ ._-]*[0-9]{1,2}(?:[^a-z0-9]|$)|Cap[ií]tulo[ ._-]*[0-9]{1,4}|(?:^|[^a-z0-9])EP?[0-9]{2,4}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])[0-9]{1,2}x[0-9]{2,3}(?:[^a-z0-9]|$)|(?:Seasons?|Temporadas?|Saison|Staffel|Sezon|Stagione|Seizoen|Сезон)[ ._-]*[0-9]{1,2}(?:[^a-z0-9]|$)|[0-9]{1,2}(?:st|nd|rd|th|ª|º)?[ ._-]*(?:Seasons?|Temporadas?|Saison|Staffel|Sezon|Stagione|Seizoen|Сезон)(?:[^a-z0-9]|$)|[EÉ]pisod(?:e|io)s?[ ._-]*[0-9]{1,4}|(?:Complete|Mini|TV|Web)[ ._-]?Series|\[Cap[ .][0-9]{3,4}\]|[\[(][0-9]{2,3} ?[~-] ?[0-9]{2,4}[\])]|[0-9]{2,4} ?~ ?[0-9]{2,4}|[ _]-[ _](?:[0-9]{2,3}|1[01][0-79][0-9]|108[1-9])(?:v[0-9])?(?:[ .](?:[^0-9]|$)|[_\[(\]~-]|$)|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ ._-][0-9]{2}[ ._-][0-9]{2}(?:[^a-z0-9]|$))
files_regex
(?i)((?:^|[^a-z0-9])s[0-9]{1,4}[ ._-]*e[0-9]{1,4}|(?:^|[^a-z0-9])s[0-9]{2,3}p[0-9]{2}|(?:^|[^a-z0-9])[0-9]{1,2}x[0-9]{2,3}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])ep?[0-9]{2,4}(?:[^a-z0-9]|$)|[eé]pisod(?:e|io)s?[ ._-]*[0-9]{1,4}|(?:^|[^a-z0-9])[0-9]{1,2}of[0-9]{1,2}(?:[^a-z0-9]|$)|[ _]-[ _](?:[0-9]{2,3}|1[01][0-79][0-9]|108[1-9])(?:v[0-9])?[ _\[(]|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ ._-][0-9]{2}[ ._-][0-9]{2}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ .][0-9]{3}[ .])
Movies¶
Add two filters to this folder. They are the same two patterns as TV Shows, used as exclusions:
not_regex
(?i)((?:^|[^a-z0-9])S[0-9]{1,4}(?:[ ._-]?E[0-9]{1,4}|E?(?:[^a-z0-9]|$))|(?:^|[^a-z0-9])[0-9]{1,2}E[0-9]{2,3}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])Ep[ .]?[0-9]{1,4}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])[0-9]{1,2}of[0-9]{1,2}(?:[^a-z0-9]|$)|Series[ ._-]*[0-9]{1,2}(?:[^a-z0-9]|$)|Cap[ií]tulo[ ._-]*[0-9]{1,4}|(?:^|[^a-z0-9])EP?[0-9]{2,4}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])[0-9]{1,2}x[0-9]{2,3}(?:[^a-z0-9]|$)|(?:Seasons?|Temporadas?|Saison|Staffel|Sezon|Stagione|Seizoen|Сезон)[ ._-]*[0-9]{1,2}(?:[^a-z0-9]|$)|[0-9]{1,2}(?:st|nd|rd|th|ª|º)?[ ._-]*(?:Seasons?|Temporadas?|Saison|Staffel|Sezon|Stagione|Seizoen|Сезон)(?:[^a-z0-9]|$)|[EÉ]pisod(?:e|io)s?[ ._-]*[0-9]{1,4}|(?:Complete|Mini|TV|Web)[ ._-]?Series|\[Cap[ .][0-9]{3,4}\]|[\[(][0-9]{2,3} ?[~-] ?[0-9]{2,4}[\])]|[0-9]{2,4} ?~ ?[0-9]{2,4}|[ _]-[ _](?:[0-9]{2,3}|1[01][0-79][0-9]|108[1-9])(?:v[0-9])?(?:[ .](?:[^0-9]|$)|[_\[(\]~-]|$)|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ ._-][0-9]{2}[ ._-][0-9]{2}(?:[^a-z0-9]|$))
not_files_regex
(?i)((?:^|[^a-z0-9])s[0-9]{1,4}[ ._-]*e[0-9]{1,4}|(?:^|[^a-z0-9])s[0-9]{2,3}p[0-9]{2}|(?:^|[^a-z0-9])[0-9]{1,2}x[0-9]{2,3}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])ep?[0-9]{2,4}(?:[^a-z0-9]|$)|[eé]pisod(?:e|io)s?[ ._-]*[0-9]{1,4}|(?:^|[^a-z0-9])[0-9]{1,2}of[0-9]{1,2}(?:[^a-z0-9]|$)|[ _]-[ _](?:[0-9]{2,3}|1[01][0-79][0-9]|108[1-9])(?:v[0-9])?[ _\[(]|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ ._-][0-9]{2}[ ._-][0-9]{2}(?:[^a-z0-9]|$)|(?:^|[^a-z0-9])(?:19|20)[0-9]{2}[ .][0-9]{3}[ .])
How the filters fit together
- TV Shows takes a release when its name looks like TV (
S01E05,S01,Season 2,1x05,Show - 12anime numbering, daily dates, and more) or any file inside it does. - Movies takes everything else. Because it reuses the TV patterns as exclusions, every release lands in exactly one of the two folders. Nothing ends up in both, and nothing goes missing.
- Add every filter listed for a folder. Using only one of them is the most common cause of TV showing up in Movies or the other way round.
- Copy each pattern in full with the copy button. Then restart cli_mount. Existing content is re-sorted after the restart, so nothing needs re-adding.
- With Allowed file types limited to video (see the example below), non-video downloads don't show up in Movies.
The categories setting (sonarr, radarr) maps to qBittorrent-compatible categories so arr apps can route downloads to the correct folder.
default_download_action decides what cli_mount does once a download is ready: Create Symlink (symlink, the default), Create STRM Files, Download Files, or No Action (none). cli_debrid doesn't use any of these outputs — it finds files in the mount itself — so none avoids a second, unused set of links in cli_mount's download folder. symlink also works. Don't use Download Files, which copies everything to local disk.
Example: symlink mode setup¶
A working cli_mount + cli_debrid setup using symlink mode, with Real-Debrid and Usenet together. Paths are examples — adjust them to your system.
What the mount looks like (host path /path/to/debrid, mapped to /mnt in cli_mount):
/path/to/debrid/
__all__/ ← every file, debrid and Usenet (cli_debrid reads from here)
Movies/ ← virtual folder: movies only
TV Shows/ ← virtual folder: TV only
torrents/ ← debrid content
nzbs/ ← Usenet content
RD/ ← one folder per debrid account, named after it
__bad__/ ← entries cli_mount flagged as broken
cli_mount — General settings
| Setting | Value | Why |
|---|---|---|
| Default download action | none (No Action) |
cli_debrid makes its own symlinks |
| Folder naming | filename |
|
| Download folder | /app/downloads |
Unused with No Action, but must be set |
| Allowed file types | mkv, mp4, m4v, avi, mov, mpg, mpeg |
Only video files show up in the mount (no .nfo, images or archives) |
| Remove stalled after | 10m |
|
| Virtual folders | Movies, TV Shows (filters from Content routing) |
Optional in symlink mode — for easier browsing |
cli_mount — Mount settings (DFS)
| Setting | Value | Notes |
|---|---|---|
| Type | dfs |
|
| Mount path | /mnt |
|
| Cache directory | /app_cache |
Map a fast disk with plenty of space here |
| Disk cache size | 100GB |
Larger cache = fewer re-downloads when rewatching |
| Cache expiry | 2h |
|
| Cache cleanup interval | 1m |
|
| Chunk size | 8MB |
|
| Read ahead size | 32MB |
|
| UID / GID / umask | 1000 / 1000 / 002 |
Match the user your media server runs as |
cli_debrid — Settings → Required Settings → File Management
| Setting | Value |
|---|---|
| File Collection Management | Symlinked/Local |
| Original Files Path | /path/to/debrid/__all__ |
| Symlinked Files Path | /path/to/symlinks — point your Plex/Jellyfin libraries here |
Same paths everywhere
cli_debrid and your media server must see the mount and the symlink folder at the same paths cli_debrid uses above, or the symlinks show up broken.
Media servers page¶
cli_mount's Media servers page (in the main menu; called Plex before 2.5.21) connects cli_mount to Plex and/or Jellyfin or Emby. It reads each server's own list of what's playing, so only real viewers count — library scans, Bazarr, cli_debrid's checks and repairs don't. It powers two features, both optional.
Connections
| Setting | Description |
|---|---|
| Plex Server URL | Must be reachable from cli_mount (not necessarily from your browser), e.g. http://192.168.1.x:32400 |
| Plex Token | Your Plex token — how to find it |
| Jellyfin or Emby Server URL | Optional, next to Plex or instead of it: sessions of every server are used |
| Jellyfin / Emby API key | Dashboard → API Keys (Jellyfin) or Settings → API Keys (Emby) |
Show precache¶
Called next-episode prewarm before 2.5.21. When someone watching passes about 70% of an episode, cli_mount fetches the first ~20% of the next episode into the cache, so it starts quickly if they keep watching.
| Setting | Description |
|---|---|
| Enable show precache | Off by default. Uses extra bandwidth and cache space, which only pays off if people keep watching. |
| Precache size cap | Max bytes fetched per precache. Blank = 256MB. |
Stream protection (Usenet)¶
Reserves Usenet (NNTP) connections for people actually watching while bulk imports are running, so a big batch of new downloads doesn't make active streams buffer. When nothing is importing, playback uses the full pool.
| Setting | Description |
|---|---|
| Protect media server streams during playback | Turns protection on. Needs a media server connection above — without one it does nothing. |
| Per-stream reserve (% of pool) | Connections reserved per confirmed Plex stream: round(total × percent ÷ 100), minimum 6 |
| Max total protected | Upper limit on connections reserved across all streams |
| Detect bytes / Detect window | How much sustained reading within the window counts as playback before the reserve kicks in |
| Idle timeout | Leave reserve mode after this long with no qualifying reads |
| Pre-cache on open | Starts caching a file as soon as it's opened; throttled to the background budget while protection is active |
Tip
Stream protection only affects Usenet streams. For debrid-only setups, only show precache applies.
Extras in movie folders (2.5.22)¶
In a movie entry, bonus videos are listed with the suffix Plex and Jellyfin read as "this is an extra": -featurette (extras, featurettes, bonus), -trailer, -deleted, -behindthescenes (also making-of), -interview, and -other (bloopers, or an unnamed video much smaller than the movie). With cli_debrid in Plex mode this stops a bonus video showing up as another version of the movie. Only the listed name changes: the main video, episodes and words that are part of a title are never renamed, and a file can still be opened by its real name, so existing symlinks keep working.
Broken files are only marked on proof (2.5.22)¶
A failed playback read marks a Usenet file broken only when the articles are missing (or short) on every provider. A read that failed for another reason (a timeout, a dropped connection, retries used up) no longer sends the file to cli_debrid's repair. The repair sweep's media probe still catches files that really don't play.
Configuring cli_debrid¶
In cli_debrid settings, set Original Files Path to the host path where your debrid library is mounted:
This is the same path Plex uses — cli_debrid follows symlinks back to this location to check file existence and build its own symlinks.
Verify the setup¶
Check the mount is populated:
You should see your content folders from Real-Debrid. Open the web UI to confirm cli_mount is connected:
Troubleshooting¶
Mount folder is empty after startup
- Check container logs:
docker logs cli_mount - Confirm
/dev/fuseexists on the host:ls -la /dev/fuse - Confirm
SYS_ADMINandapparmor:unconfinedare set on the container
"Transport endpoint is not connected"
The FUSE mount dropped. Restart the container:
DFS: files appear but won't play smoothly
Increase read_ahead_size (e.g. 256MB) or switch to rclone mode.
rclone mode: container exits immediately
Verify the cache path exists on the host and is writable. Also check docker logs cli_mount for the specific error.
Usenet with cli_mount¶
cli_mount also supports Usenet downloads. cli_debrid can submit NZBs to cli_mount from Newznab scrapers and manage them through the same queue as debrid torrents.
Usenet Mount settings¶
In Settings → Required Settings → Usenet Mount:
| Setting | Description |
|---|---|
| Enable Usenet Mount | Turn on Usenet support |
| Provider | cli_mount. The Detect button under it finds cli_mount on your network and fills in Mount URL and cli_mount Data Path |
| Mount URL | cli_mount base URL, e.g. http://cli_mount:8282 (default port 8282). Don't use localhost or port 8888: inside the cli_debrid container those point at cli_debrid and its Phalanx DB |
| API Token | cli_mount API token, only if you turned on authentication in cli_mount |
| Download Folder / Category | Leave empty to use cli_mount's default download folder |
| cli_mount Data Path | cli_mount's data folder as cli_debrid sees it, default /climount_data. Add - /path/to/appdata/cli_mount:/climount_data to cli_debrid's volumes. Used by the DB tools below and by Tools → Usenet → Migrate between usenet providers |
cli_mount DB tools¶
When cli_mount Data Path is configured, these tools work on the Maintenance page:
- cli_mount DB Cleanup (Cleanup & repair tab) — remove entries for a specific debrid provider from cli_mount's
entries.dbanditems.dbusing infohash matching. Useful when migrating away from a debrid provider. - Backup cli_mount Databases (Backups tab) — backs up
entries.dbanditems.dbon the same schedule as the CLI database backup - Restore cli_mount Database from Backup (Backups tab) — restore from a previous backup
- Clean Up Old cli_mount Backup Files (Backups tab) — remove old backup files to free disk space
See Getting Started for the full Usenet setup.
Further reading¶
- cli_mount GitHub
- Newznab scrapers — add Usenet indexers
- Debrid Manager — NZB health and the repair engine
- Configure Plex to add libraries pointing at your mount path
- Configure cli_debrid with the correct Original Files Path