​

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