Usage#

🚀 Running DUMB#

DUMB automatically starts the services defined in dumb_config.json in the proper order. Each service can also be managed independently using the DUMB Frontend or by directly modifying the configuration.

Important: Configure API Key Before Startup

DUMB is preset to disable all services, other than the API and Frontend on the first startup. An Onboarding process is currently in development for the Frontend. As an interim solution, please see the API: Start Core Service for info on using the API to preconfigure and start services.

🔄 Automatic Service Start#

All services with "enabled": true in the config will be started on container launch.

If a service fails to start, check its log file in the /log directory (or wherever log_dir is set).

🔃 Managing Updates#

🛠️ Manual Updates#

Each service can be updated by modifying the configuration file or using the DUMB Frontend.

Updates include:

Branch switching
Version pinning
Auto-update toggling

⚙️ Auto-Update#

Some services support automatic updates.

Enable by setting:

"auto_update": true,
"auto_update_interval": 24

auto_update_interval is measured in hours.

Services supporting auto-updates:

DUMB Frontend
Plex Media Server (Future release)
Riven Backend and Frontend
Decypharr
CLI Debrid
Plex Debrid
Zilean
Zurg

⚡ Shutdown Handling#

DUMB handles graceful shutdown of all services.

This includes:

Stopping running processes
Unmounting rclone mounts
Syncing configuration states

To allow time for clean shutdowns, use:

docker-compose:
  stop_grace_period: 60s

📌 Tips#

Always monitor /log/*.log files for troubleshooting or monitor the logs from the DUMB Frontend.
Ensure PostgreSQL is running before launching services that depend on it.
If using Real-Debrid, ensure api_key is provided in rclone or Zurg instances.
Logs can be colored if color_log is enabled in the config.