Before you install¶
Have a host, persistent storage, and credentials for the services you plan to use. DUMB creates its initial configuration at startup; you do not need to write a complete dumb_config.json first.
Plan the library boundary¶
Choose the layout before configuring host mounts. Seeing the same folder name in two applications does not prove that they can read the same files.
flowchart TD
Consumers["Where will the library be read?"] --> Inside["Only apps inside DUMB"]
Consumers --> Container["Another container on this host"]
Consumers --> Remote["Another machine"]
Inside --> Normal["Use the normal media bind"]
Container --> Paths["Match library and symlink target paths"]
Paths --> FUSE{"Must it see DUMB-created FUSE submounts?"}
FUSE -->|Yes| Shared["Prepare a shared host mount and propagation"]
FUSE -->|No| Files["Verify ordinary file and link access"]
Remote --> Export["Plan an explicit sharing method"]
Shared --> Test["Verify access from the actual reader"]
Files --> Test
Export --> Test
Choose your platform first¶
These guides explain the installation steps for each platform. Use this page to prepare, then follow your selected guide.
- Docker Compose · Portainer · Dockge
- Unraid · Synology · QNAP · TrueNAS SCALE
- Windows / WSL2 · Proxmox LXC
Host requirements¶
| Requirement | Guidance |
|---|---|
| Runtime | Docker Engine on Linux, including WSL2; or the native Proxmox LXC helper |
| CPU and memory | Start around 2 vCPU and 2 GB RAM for a small stack. This is a planning estimate; source builds, databases, transcoding, and larger service selections need more. |
| Storage | Persistent storage for configuration, databases, logs, and library paths; SSD storage is preferable for databases and source builds. |
| User and group | Non-root PUID and PGID with access to the host directories. Check them with id -u and id -g. |
| Networking | Access to image/package registries and your providers. Publish dashboard port 3005 unless you deliberately change it. |
Docker Desktop and external mounts
Docker Desktop does not support the bind mount propagation needed to share DUMB-created FUSE/rclone submounts with containers outside DUMB. For Windows, use Docker Engine inside WSL2. See Docker's propagation documentation.
Accounts and credentials¶
| Selected integration | Have this ready |
|---|---|
| Debrid | API key for each selected provider |
| Usenet | NNTP host, port, username/password, connection limit, and TLS setting |
| Plex | Claim/token and server address when the selected integration requires them |
| Private or sponsored GitHub repository | A read-capable GitHub token with the access that repository requires |
| Cloudflared | A Cloudflare Tunnel token |
You only need credentials for the integrations you enable. See integration tokens.
Persistent directories¶
The maintained Compose layout mounts four host directories. Native LXC uses the same absolute paths directly in the guest.
| Path inside DUMB | Contents |
|---|---|
/config |
DUMB configuration, authentication data, migration jobs, snapshots, and feature state |
/log |
DUMB and collected service logs |
/data |
Persistent application data. DUMB maps internal paths such as /plex, /postgres_data, and /decypharr into subdirectories here. |
/mnt/debrid |
Mounts, generated links, and library paths |
Keep these paths when recreating or upgrading the container. Store a separate backup of important configuration and application data; a bind mount alone is not a backup.
Existing installations
Separate direct mounts such as /postgres_data or /plex are legacy or advanced layouts. They can prevent DUMB from creating managed data symlinks. Preserve an existing layout until you have reviewed its migration; do not add those mounts to a new deployment by default.
Decide who reads the library¶
- Everything inside DUMB: use a normal
/mnt/debridbind mount. - External Arr or media-server containers: use matching library and target paths. If they need DUMB-created FUSE/rclone submounts, prepare a shared host mount and use
:rsharedon DUMB's bind, with the appropriate consumer propagation. - Remote machines: plan an explicit sharing method. A path that exists inside DUMB does not automatically become available elsewhere.
The need for propagation comes from the deployment topology, not the workflow's name. Adding :rshared to Compose does not prepare the host mount.
Ready to deploy¶
Choose your deployment guide, start DUMB, and open http://<host>:3005. Then follow onboarding.
Development update · not in the released 2.23.0 docs
Review the retained setup checklist for automatic and manual integration tasks.