Skip to main content
This runbook helps you recover from database corruption in Beads.

Symptoms

  • Error messages during bd commands
  • “database is locked” errors that persist
  • Missing issues that should exist
  • Inconsistent database state

Diagnosis

Solution

Step 1: Stop the Dolt server
Step 2: Back up current state
Step 3: Preview what doctor would fix
Step 4: Rebuild database
Step 5: Verify recovery
Step 6: Restart the Dolt server

Prevention

  • Let the Dolt server handle synchronization
  • Use bd dolt stop before system shutdown
  • Run bd doctor periodically to catch issues early