Docker

📦 Deploying DMB with Docker#

Welcome to the official Docker deployment guide for DMB (Debrid Media Bridge) — a powerful all-in-one container designed to streamline media management using debrid services.

This guide will walk you through every step, from installing Docker to setting up and running the DMB container. Whether you're new to Docker or just need a quick refresher, you'll be up and running in no time.

✅ Prerequisites#

Before you begin, make sure you have the following:

A system running Ubuntu 20.04 or later
A non-root user with sudo privileges
An active internet connection
Basic familiarity with using the terminal

Tip

This guide assumes you're installing Docker on a fresh Ubuntu setup. If you're on Windows, refer to the Windows Setup Guide (Docker/WSL).

🐳 Install Docker#

From Ubuntu, install Docker by pasting the following into the Ubuntu Command Line Interface (CLI); follow the prompts.
```
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
```

Note

If you receive the following prompt during the Docker install, then follow the steps here: Windows Setup Guide (Docker/WSL)

WSL DETECTED: We recommend using Docker Desktop for Windows.
Please get Docker Desktop from https://www.docker.com/products/docker-desktop/

✅ Confirm Docker Install#

Enter the following command:
```
docker compose version
```
If the output is similar to the below, then docker and docker compose were successfully installed:
```
ubuntu@DMB:~$ docker compose version
Docker Compose version v2.24.2
```

📁 Define the Directory Structure#

Note

If you already have a directory structure you'd like to use, then you can skip this step.

Create a directory for docker in your user directory and change directories to docker.
```
cd ~ && mkdir docker && cd docker
```

Create the DMB directories.

mkdir -p DMB/config DMB/log DMB/Zurg/RD /DMB/Zurg/mnt DMB/Riven/data DMB/Riven/mnt DMB/PostgreSQL/data DMB/pgAdmin4/data /DMB/Zilean/data

✏️ Download and Edit the docker-compose.yml#

Important

The docker-compose.yml file will need to be edited to include the necessary environment variable values.

Download the latest docker-compose.yml from the GitHub repository with the following:

curl -O https://raw.githubusercontent.com/I-am-PUID-0/DMB/master/docker-compose.yml

Run the following command to update the paths in the docker-compose.yml

sed -i "s|/home/username/docker/DMB|$HOME/docker/DMB|g" docker-compose.yml

Run the following command to update the docker-compose.yml

timezone

The bellow command defaults to TZ=UTC, update while running the command if desired

Riven Frontend Origin

The RIVEN_FRONTEND_ENV_ORIGIN must be in the format http://<IP-or-Hostname>:<port>.
This should match the exact address you use to access the Riven Frontend from your browser.

read -p "Enter your timezone [UTC]: " TZ && TZ=${TZ:-UTC} && \
read -p "Enter your RealDebrid API key: " RD_KEY && \
read -p "Enter your Riven Frontend Origin (e.g., http://0.0.0.0:3000): " RIVEN_ORIGIN && \
sed -i \
  -e "s|TZ=|TZ=$TZ|" \
  -e "s|PUID=|PUID=$(id -u)|" \
  -e "s|PGID=|PGID=$(id -g)|" \
  -e "s|ZURG_INSTANCES_REALDEBRID_API_KEY=|ZURG_INSTANCES_REALDEBRID_API_KEY=$RD_KEY|" \
  -e "s|RIVEN_FRONTEND_ENV_ORIGIN=.*|RIVEN_FRONTEND_ENV_ORIGIN=$RIVEN_ORIGIN|" \
  docker-compose.yml

🚀 Start up the Docker Compose#

Note

The following command starts Docker Compose in detached mode, meaning it runs in the background and frees up your terminal.

If you omit the -d flag, Docker Compose will run in the foreground, streaming all container logs directly to your terminal.

This is useful for debugging or monitoring in real time, but you will need to open another terminal to run additional commands while it's running.

Pressing Ctrl + C will shut down all running containers.
To exit without stopping the container(s), you must start Docker Compose in detached mode using -d.

⚠️ There is no built-in "detach shortcut" when running in the foreground — to keep containers running after exit, always use the below command

sudo docker compose up -d

Example output:

ubuntu@DMB:~/docker$ sudo docker compose up -d
[+] Running 1/2
 ⠋ Network docker_default  Created                                                                                                                                                       1.1s 
 ✔ Container DMB       Started

✅ Once started, the container will run in the background.

🎉 That’s It!#

Once deployed, DMB will initialize and make its services available at their respective ports (e.g., DMB Frontend at :3005, API at :8000, etc.).

You can now manage DMB entirely through the DMB Frontend, or explore the Configuration docs to adjust settings as needed.

🛠️ Additional Useful Commands#

▶️ Attach to the Running Container#

sudo docker attach DMB

🔄 Detach Without Stopping the Container#

Press Ctrl + P followed by Ctrl + Q.

This sequence sends a signal to Docker to detach from the container while leaving it running in the background.

Important

Use this sequence rather than simply closing the terminal window or using Ctrl + C, as those actions might stop the container.

Note

Remember, Ctrl + P + Ctrl + Q must be pressed in quick succession.

You press Ctrl + P first, and while holding Ctrl, press Q.

After this, you will be returned to your host terminal, and the container will continue to run in the background.

📜 View Docker Container Logs#

To view the container logs, enter the following:
```
sudo docker container logs DMB
```
Alternatively, use -f to follow the logs in real-time. You can exit with Ctrl + C (this does not stop the container).
```
sudo docker logs -f DMB
```

🧯 Shutdown Docker Compose#

sudo docker compose down

Example output:

ubuntu@DMB:~/docker$ sudo docker compose down
[+] Running 2/2
 ✔ Container DMB       Removed                                                                                                                                                      10.4s 
 ✔ Network docker_default  Removed