Step 2 — Mount your storage¶
Before cli_debrid can manage your library, your debrid and/or Usenet content needs to be mounted as a local folder. Your media server (Plex/Jellyfin) reads from this folder as if it were a regular hard drive — nothing is downloaded to your server.
These tools handle this:
| Tool | Debrid | Usenet | Notes |
|---|---|---|---|
| Built-in mount | Real-Debrid, AllDebrid, Torbox, Premiumize, Debrid-Link, HighWay | ✓ | Default. Runs inside cli_debrid, no extra container |
| cli_mount | Real-Debrid, AllDebrid, Torbox, Premiumize | ✓ | All-in-one in its own container, built alongside cli_debrid |
| Decypharr | Real-Debrid, AllDebrid, Torbox, Premiumize | The original project cli_mount is forked from | |
| Zurg + rclone | Real-Debrid, AllDebrid, Debrid-Link | ✓ (Zurg 2.0) | Long-standing, well-tested Real-Debrid setup |
Choose one:
- Most setups (Usenet, debrid, or both): the built-in mount. Nothing to install here; you set it up in Step 4.
- A separate mount container, or a host where cli_debrid can't get FUSE access: cli_mount — it handles debrid and Usenet in a single container and works directly with cli_debrid for imports and repairs. If you only use Real-Debrid and already run Zurg, that works too.
Option A — Built-in mount¶
cli_debrid's own mount engine runs inside the cli_debrid container. It streams NZBs from your news server and the finished torrents in your debrid account. The container needs FUSE access and a shared mount folder, covered in Step 3.
Full guide: Built-in mount
Skip ahead to Step 3; the mount appears once cli_debrid runs.
Option B — cli_mount¶
cli_mount mounts your debrid library and streams Usenet NZBs from your news server, all in one container. It's a fork of Decypharr maintained by mash2k3 (source).
Full setup guide: cli_mount
Installing both? Use one compose file
The Docker guide runs cli_mount and cli_debrid together from one compose file, so this step and Step 3 happen at once.
In short:
- Run the
ghcr.io/mash2k3/cli_mount:devcontainer (needs/dev/fuse), with your mount folder mapped to/mnt - Open the cli_mount web UI at
http://YOUR_SERVER_IP:8282 - Debrid: under Settings → Providers → Debrid, click Add Account and enter your debrid provider and API key
- Usenet: under Settings → Providers → Usenet, click Add Server and enter your provider's host, port (
563with SSL), username, password and max connections
After setup you will have a mount folder (e.g. /path/to/debrid) containing your debrid and Usenet files.
Note the path and the cli_mount URL (http://YOUR_SERVER_IP:8282) — you'll need both in Step 4.
Option C — Decypharr¶
Decypharr is an all-in-one debrid mount tool that also handles symlink management and supports multiple debrid providers.
Full setup guide: Decypharr
Option D — Zurg + rclone¶
Zurg exposes your debrid library as a WebDAV server. rclone mounts it as a local filesystem.
Full setup guide: Zurg + rclone
After setup you will have a folder like /mnt/zurg (or /mnt/user/zurg on Unraid) containing your debrid files organised as:
Note the path — you'll need it in the next step.
Verify the mount works¶
Before proceeding, confirm the mount is working by listing your mount path:
You should see your files listed (a new Usenet-only setup will be empty until the first NZB is added). If the command fails, fix the mount before continuing.
Mount must be working before installing cli_debrid
cli_debrid needs to be able to read the mount path at startup. If the mount isn't working, cli_debrid won't be able to verify files exist.