beads/website/versioned_docs/version-1.0.0/getting-started/upgrading.md
Ben Madore 3b39ce577a
docs: update user-facing URLs from steveyegge/beads to gastownhall/beads
Co-authored-by: Ben Madore <823868+madorb@users.noreply.github.com>
2026-04-24 08:17:42 -07:00

1.1 KiB

id title sidebar_position
upgrading Upgrading 4

Upgrading bd

Upgrade Commands

Use the command that matches your install method:

Install method Command
Homebrew brew upgrade beads
Install script (macOS/Linux) curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
PowerShell (Windows) irm https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1 | iex
npm npm update -g @beads/bd
go install go install github.com/steveyegge/beads/cmd/bd@latest

After Upgrading

bd info --whats-new     # Check what changed
bd hooks install        # Update git hooks to match new version
bd migrate --dry-run    # Check for database migrations
bd migrate              # Apply if needed

Git hooks are versioned with bd - outdated hooks may miss auto-sync features. If using Dolt server mode, restart with bd dolt stop && bd dolt start.

Recovery

If an upgrade causes issues:

bd dolt pull                        # Restore from remote
bd backup restore [path] --force    # Or restore from backup