Skip to content

Service Reset and Removal

DUMB can reset one previously configured service or instance without requiring a full stack reset. When the backend advertises service_reset, open the service page and select Reset / Remove.

Reset or remove one service

  1. Open the service or instance page and choose Tools → Reset / Remove.
  2. Choose Reset DUMB configuration to keep application files and data, or Remove service files to delete only the managed paths in the preview.
  3. Read Review warnings, Always retained, and, for removal, Managed paths to clear. Cancel if any path or dependency is unexpected. Make an independent application backup before deleting files.
  4. Type the exact process name shown in the confirmation field.
  5. Select Reset DUMB configuration or Remove selected service files. Wait for the result; the selected service is stopped and disabled by this operation.
  6. Check the confirmation and service state. To use the service again, review its saved settings and application data before enabling and starting it. If the operation fails, follow recovery guidance before retrying.
Technical details: reset transaction and scheduled-job cleanup

The workflow always:

  1. builds a read-only preview;
  2. shows the exact configuration action and every managed path eligible for cleanup;
  3. stops the selected process;
  4. cancels its automatic-update and scheduled symlink-backup jobs;
  5. writes a private backup of the complete DUMB configuration; and
  6. applies the selected reset or removal.

You must type the exact process name before DUMB accepts either operation.

Choose an operation

Both choices stop and disable the selected service. Removal needs a separate review of the files at risk:

flowchart TD
    accTitle: Choose reset or removal after reviewing the preview
    accDescr: Reset keeps application files; removal deletes only previewed managed paths. Back up and cancel if the target or paths are unexpected.
    Target["Open Reset / Remove for the exact service"] --> Choice{"Keep the application's files?"}
    Choice -->|Yes| Reset["Reset DUMB configuration"]
    Choice -->|No| Backup["Keep an independent application backup"]
    Backup --> Remove["Remove service files"]
    Reset --> Preview["Review warnings, retained paths and dependencies"]
    Remove --> Preview
    Preview --> Expected{"Preview matches your intention?"}
    Expected -->|No| Cancel["Cancel and investigate"]
    Expected -->|Yes| Confirm["Type the exact process name and confirm"]
    Confirm --> Verify["Check the result before enabling the service again"]

Reset DUMB configuration

This option keeps the service's application files and data. DUMB disables the selected service/instance and restores its DUMB configuration fields to the current defaults.

  • A single-instance service returns to its disabled default block.
  • A built-in/default instance returns to its disabled instance template.
  • A custom instance keeps its identity, port, and instance-specific paths, but other DUMB settings and generated secrets return to template values.

Use this when DUMB configuration is wrong but the application's own database, settings, and runtime files should remain available.

Remove service files

This option performs the configuration reset and also clears the previewed DUMB-owned config/runtime/data paths.

  • A custom instance is removed from the service's instances object. If it was the last instance, DUMB writes the disabled default template in the same operation instead of temporarily saving an empty instances object.
  • A required default instance or single-instance service is reset to its disabled template. DUMB keeps that template because config loading would recreate it anyway.
  • Only paths attributed exclusively to the selected process are eligible.

Removed application files are not backed up and cannot be restored by DUMB. Review the path list carefully.

Safety boundary

DUMB intentionally retains:

  • /mnt content, mountpoints, media roots, and symlink libraries;
  • shared install/dependency caches;
  • PostgreSQL databases and other external data stores;
  • directories shared by another configured DUMB service;
  • custom paths outside the selected service's known DUMB-managed root; and
  • configuration belonging to other services.

For example, CLI Debrid and CLI Battery share parts of the CLI Debrid tree, while rclone instances share an rclone configuration file. The preview keeps those shared locations and explains why. PostgreSQL is a stack dependency, so resetting its DUMB block never deletes the shared database cluster.

Database-backed services

Removing a service's files does not drop its PostgreSQL database. A later reinstall may reconnect to existing database state. Drop or archive a database separately only after confirming that no other service uses it.

Dependent services

DUMB warns when another configured service references the target, but it does not rewrite that other service's core_service, core_services, URL, mount, or application integration settings. Review dependencies before starting the remaining stack.

Configuration backup and recovery

Before changing dumb_config.json, DUMB writes a mode-0600 full-config backup under:

/config/service-reset-backups/

The API response includes the exact backup path. The backup can recover DUMB configuration, including a removed custom instance, but it does not contain deleted service files.

If an operation reports failure, the selected process remains stopped. Check the DUMB log and the backup directory before retrying. Restore configuration only while DUMB is stopped, then restart the container so configuration is reloaded consistently.

Technical details: reset/removal API

API

The frontend uses two capability-gated endpoints:

GET /api/process/service-reset/preview?process_name=Sonarr%20Movies&action=remove
POST /api/process/service-reset
Content-Type: application/json

{
  "process_name": "Sonarr Movies",
  "action": "remove",
  "confirmation": "Sonarr Movies"
}

Supported actions are reset and remove. Use the preview returned immediately before the POST; DUMB recalculates and validates the plan again when applying it.

The DUMB API and DUMB Frontend control-plane services cannot be reset through this workflow.