Skip to content

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/fuse available 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.

docker-compose.yml
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
  1. Host path where your debrid library will be mounted — point Plex and cli_debrid here
  2. Cache directory for rclone VFS or DFS chunk cache
  3. 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 compose up -d
docker compose logs -f
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

mkdir -p ~/cli_mount && cd ~/cli_mount

Step 2 — Download cli_mount

  1. Go to cli_mount releases on GitHub
  2. Download the latest release for your platform:
    • Linux x64: cli_mount_Linux_x86_64.tar.gz
    • Linux ARM64: cli_mount_Linux_arm64.tar.gz
  3. Extract the archive:
tar -xzf cli_mount_Linux_x86_64.tar.gz
  1. Place the extracted binary in your appdata folder and make it executable:
chmod +x cli_mount

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:

./cli_mount --config /path/to/cli_mount/

To run it as a background service, create a systemd unit:

/etc/systemd/system/cli_mount.service
[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
systemctl enable cli_mount
systemctl start cli_mount

Step 5 — Verify

Open the cli_mount web UI to confirm it is running and connected:

http://YOUR_SERVER_IP:8282

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

/path/to/appdata/cli_mount/

Step 2 — Download cli_mount

  1. Go to cli_mount releases on GitHub
  2. Download the latest cli_mount_Linux_x86_64.tar.gz
  3. Extract the archive and place the cli_mount binary 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)

#!/bin/bash
pkill cli_mount

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:

http://YOUR_SERVER_IP:8282

cli_mount has a native Windows binary — no Docker required.

Step 1 — Download cli_mount

  1. Go to cli_mount releases on GitHub
  2. Download the latest cli_mount_Windows_x86_64.zip
  3. Extract the zip and place cli_mount.exe in 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:

.\cli_mount.exe --config C:\cli_mount\

Step 4 — Run at startup (optional)

To start cli_mount automatically when Windows boots:

  1. Press Win + R, type shell:startup, press Enter
  2. Create a shortcut to cli_mount.exe in 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:

http://localhost:8282

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
  1. 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)

#!/bin/bash
fusermount -uz /path/to/debrid

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:

#!/bin/bash
# Unmount rclone first, then stop cli_mount
fusermount -uz /path/to/debrid
sleep 5
pkill cli_mount

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 on TV 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 - 12 anime 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.

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:

/path/to/debrid

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:

ls /path/to/debrid

You should see your content folders from Real-Debrid. Open the web UI to confirm cli_mount is connected:

http://YOUR_SERVER_IP:8282

Troubleshooting

Mount folder is empty after startup

  • Check container logs: docker logs cli_mount
  • Confirm /dev/fuse exists on the host: ls -la /dev/fuse
  • Confirm SYS_ADMIN and apparmor:unconfined are set on the container

"Transport endpoint is not connected"

The FUSE mount dropped. Restart the container:

docker restart cli_mount

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.db and items.db using infohash matching. Useful when migrating away from a debrid provider.
  • Backup cli_mount Databases (Backups tab) — backs up entries.db and items.db on 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