Skip to content

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:

  1. Run the ghcr.io/mash2k3/cli_mount:dev container (needs /dev/fuse), with your mount folder mapped to /mnt
  2. Open the cli_mount web UI at http://YOUR_SERVER_IP:8282
  3. Debrid: under Settings → Providers → Debrid, click Add Account and enter your debrid provider and API key
  4. Usenet: under Settings → Providers → Usenet, click Add Server and enter your provider's host, port (563 with 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:

/mnt/zurg/
  __all__/          ← all files
  movies/           ← Zurg-categorised movies
  shows/            ← Zurg-categorised shows

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:

Check this after Step 4, once cli_debrid runs:

ls /path/to/clid

ls /path/to/debrid
ls /path/to/debrid
ls /mnt/zurg/__all__

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.


Next step

Step 3 — Install cli_debrid