Services Overview#
DUMB is composed of multiple services that work together to provide a complete automated media management system. Services are categorized into:
- DUMB Services: Required for system orchestration and user interaction
- Core Services: Manage Debrid content orchestration or media playback
- Dependent Services: Required by one or more core services to function
- Optional Services: Enhance or simplify workflows but are not required
🧹 How the Services Work Together#
DUMB is built as a collection of microservices that communicate over internal APIs and shared paths. Below is an example flow:
-
Platform Infrastructure
- 🔐 DUMB API coordinates and manages all service interactions
- 🗃️ DUMB Frontend provides the web interface for managing and viewing services
-
Debrid Orchestration & Content Management
- 🧠 Riven Backend, 🧲 CLI Debrid, 🚁 Plex Debrid, and 🌐 Decypharr each serve as a Debrid orchestrator: requesting, managing, and monitoring content acquisition workflows
- These core services integrate with providers like Trakt, Overseerr, and Debrid APIs to manage what content gets fetched
-
Media Playback
- 🎥 Plex is the core service that hosts and serves collected content to users
- It relies on symlinked or mounted content made available through rclone/Zurg from the other core services
- 🎥 Plex is the core service that hosts and serves collected content to users
-
Storage & Retrieval
- 📁 rclone mounts remote Debrid storage for local access
- ⚡ Zurg provides WebDAV access to debrid downloads
-
Metadata & Caching
- 🛢 CLI Battery and 🌐 Phalanx DB serve as local or distributed metadata stores
- 🛢 Zilean caches metadata and exposes a Torznab-compatible indexer for scraping optimization
-
Database Layer
- 📂 PostgreSQL stores metadata for Riven, Zilean, and pgAdmin
- 📊 pgAdmin is a GUI for exploring PostgreSQL databases
🧱 Quick Reference#
| Service | Type | Key Role |
|---|---|---|
| DUMB API | DUMB | Centralized orchestration |
| DUMB Frontend | DUMB | Web-based control panel |
| Riven Backend | Core | Debrid orchestrator (searching, scraping, automation) |
| CLI Debrid | Core | Debrid orchestrator (list scanning, upgrades, Plex watch) |
| Plex Debrid | Core | Debrid orchestrator (direct scraping and playback prep) |
| Decypharr | Core | Debrid orchestrator for Arrs via torrent API integration |
| Plex | Core | Media server for hosting and playing content |
| rclone | Dependent | Mount Debrid storage |
| Zurg | Dependent | Serve Debrid content via WebDAV |
| PostgreSQL | Dependent | Persistent metadata database |
| CLI Battery | Dependent | Metadata service for CLI Debrid |
| Phalanx DB | Dependent | Distributed metadata storage |
| Zilean | Optional | Metadata cache and scraping backend |
| pgAdmin | Optional | PostgreSQL GUI |
| Riven Frontend | Optional | UI for Riven Backend |
🧠 Tips#
- Use the onboarding UI to enable only the services you need
- Services will auto-start in dependency order
- Logs and errors can be viewed in the DUMB Frontend