Skip to content

Step 3 — Install cli_debrid

Select your platform below. All methods install the same app — only the steps differ.

Using the built-in mount?

The engine runs inside cli_debrid's container, so the container needs devices: [/dev/fuse], cap_add: [SYS_ADMIN], security_opt: [apparmor:unconfined] and the mount folder bound with rshared (/mnt/clid:/mnt/clid:rshared). docker-compose.builtin.yml has all of it (Docker guide). Give your media server the same folder at the same path with rslave.

Using cli_mount?

cli_mount runs as its own container next to cli_debrid (you set it up in Step 2). Two things to get right:

  • Same mount path in both containers. Map your mount folder into cli_debrid (and your media server) at the same path cli_mount uses, so file paths line up.
  • Reach cli_mount by IP or container name, not localhost. cli_mount listens on port 8282 by default — use http://YOUR_SERVER_IP:8282 (or the container name on a shared Docker network). localhost inside the cli_debrid container is cli_debrid itself.

  • Keep cli_mount on port 8282. That's cli_mount's default. Port 8888 is taken by cli_debrid's built-in Phalanx DB — the cli_debrid docker-compose.yml publishes it — so don't move cli_mount to 8888 if both run on the same host.

Optional: also map cli_mount's appdata folder into cli_debrid as /climount_data to enable cli_mount DB backup and cleanup tools.


The easiest method on Unraid is via Community Applications using the pre-configured template.

Full guide: Unraid installation

Quick steps:

  1. Open the Apps tab in Unraid
  2. Search for CLI_Debrid
  3. Click Install on the template by mash2k3
  4. Set your paths and timezone
  5. Click Apply

Once running, go to http://YOUR_UNRAID_IP:5000

Works on any Linux host, macOS, or Windows with Docker Desktop.

Full guide: Docker installation

Quick steps:

mkdir -p ~/cli_debrid && cd ~/cli_debrid
curl -O https://raw.githubusercontent.com/godver3/cli_debrid/dev/docker-compose.yml
# Edit docker-compose.yml — update volume paths and timezone
docker compose up -d

Once running, go to http://YOUR_SERVER_IP:5000

Full guide: Ubuntu installation

Quick steps:

  1. Install Docker Engine (not Docker Desktop)
  2. Create your compose file with correct volume paths
  3. Run docker compose up -d

Once running, go to http://YOUR_SERVER_IP:5000

Run cli_debrid in an LXC container or a VM with Docker.

Full guide: Proxmox installation

Recommended approach: Use a Debian/Ubuntu LXC, install Docker inside it, then follow the Docker steps.

Run cli_debrid as a TrueNAS App (SCALE) or in a jail (CORE).

Full guide: TrueNAS installation

TrueNAS SCALE: Use the Docker Compose method inside a Custom App or deploy via TrueCharts if available.

A native Windows executable is available — no Docker required.

Full guide: Windows installation

Symlinks on Windows

Windows requires Developer Mode enabled for symlink support. Plex does not support symlinks on Windows — use Jellyfin instead, or run cli_debrid in Docker.


First launch

Regardless of platform, when you first open http://YOUR_IP:5000 you will see:

Phalanx DB prompt — Select No / Disable unless you specifically want this experimental feature.

The onboarding wizard will then launch automatically and guide you through initial configuration.

Tip

Have your API keys and paths from Step 1 and Step 2 ready before proceeding through onboarding.


Next step

Step 4 — Configure cli_debrid