​
Reset Buster Services

The buster reset command performs a complete reset of your local Buster environment. This is useful when you want to start with a clean installation or resolve issues with your current setup.

​
Basic Usage

buster reset

The reset command has no additional options.

​
What It Does

The reset command performs these steps:

  1. Stops all Buster services: Shuts down all running Docker containers
  2. Removes Docker images: Deletes the Docker images used by Buster
  3. Wipes the ~/.buster directory: Removes all configuration files and data
  4. Preserves credentials: Keeps only your credentials.yml file if it exists

This is a destructive operation that completely reinitializes your Buster environment. All data in the local database will be lost, and all configuration settings (except credentials) will be reset to defaults.

​
Confirmation Required

Because this is a destructive operation, the command requires explicit confirmation:

WARNING: This command will stop all Buster services, attempt to remove their current images, and then restart them from scratch.
This can lead to a complete wipe of the Buster database and any other local service data.
The ~/.buster directory will be wiped, except for ~/.buster/credentials.yml if it exists.
This action is irreversible.
Are you sure you want to proceed with resetting? (y/n):

You must type y to confirm the reset. Any other input will cancel the operation.

​
Reset Process Details

The reset operation has three main phases:

  1. Service Shutdown Phase:

    • Stops all Docker containers using docker compose down
    • Reports any issues but continues with the reset process

  2. Image Removal Phase:

    • Identifies all Docker images used by Buster
    • Removes each image individually
    • Reports the status of each image removal

  3. Directory Cleanup Phase:

    • Backs up the credentials.yml file if it exists
    • Removes the entire ~/.buster directory
    • Creates a fresh ~/.buster directory
    • Restores the backed-up credentials file

​
When to Use Reset

You should consider using the reset command when:

  • Your Buster installation is not working correctly
  • You want to start with a clean environment
  • You’ve made configuration changes that caused problems
  • You want to clear all data and start fresh
  • Docker-related issues prevent normal operation

​
After Resetting

After a successful reset, you need to run buster start to rebuild your Buster environment. This will:

  1. Extract all necessary files to the newly created ~/.buster directory
  2. Prompt for any required configuration (API keys, etc.)
  3. Download and build Docker images
  4. Start all Buster services in a fresh state

​
Troubleshooting

If you encounter issues with the reset command:

  • Permission errors: Ensure you have permission to manage Docker and write to the ~/.buster directory
  • Docker issues: Check if Docker is running properly
  • Locked files: Close any applications that might be accessing files in the ~/.buster directory