gastownhall/beads · error

automatic integrity recovery is disabled for server-mode rep

Error message

automatic integrity recovery is disabled for server-mode repos because it can replace the wrong Dolt root; preserve %s and verify the configured database %q manually before reinitializing

What it means

Error "automatic integrity recovery is disabled for server-mode repos because it can replace the wrong Dolt root; preserve %s and verify the configured database %q manually before reinitializing" thrown in gastownhall/beads.

Source

Thrown at cmd/bd/doctor/fix/database_integrity.go:90

	}

	fmt.Printf("  Recovered Dolt database\n")
	fmt.Printf("  Corrupted database preserved at: %s\n", filepath.Base(backupPath))
	return nil
}

func serverModeIntegrityRecoveryGuard(beadsDir string) error {
	cfg, err := configfile.Load(beadsDir)
	if err != nil || cfg == nil || !cfg.IsDoltServerMode() {
		return nil
	}

	dbName := cfg.GetDoltDatabase()
	if dbName == "" {
		dbName = configfile.DefaultDoltDatabase
	}

	return fmt.Errorf(
		"automatic integrity recovery is disabled for server-mode repos because it can replace the wrong Dolt root; preserve %s and verify the configured database %q manually before reinitializing",
		getDatabasePath(beadsDir),
		dbName,
	)
}

View on GitHub (pinned to 71377f2769)

When it happens

Trigger: Thrown at cmd/bd/doctor/fix/database_integrity.go:90 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gastownhall/beads@71377f2769 (2026-08-30). Data as JSON: /api/errors/00dbdc7f67bd33e5. Report an issue: GitHub.