Skip to main content
Bun can upgrade itself using the built-in bun upgrade command. This is the fastest way to get the latest features and bug fixes.
terminal
bun upgrade
This downloads and installs the latest stable version of Bun, replacing the currently installed version.
To see the current version of Bun, run bun --version.

​
Verify the upgrade

After upgrading, verify the new version:
terminal
bun --version
# Output: 1.x.y

# See the exact commit of the Bun binary
bun --revision
# Output: 1.x.y+abc123def

​
Upgrade to canary builds

Canary builds are automatically released on every commit to the main branch. These are untested but useful for trying new features or verifying bug fixes before they’re released.
terminal
bun upgrade --canary
Canary builds are not recommended for production use. They may contain bugs or breaking changes.

​
Switch back to stable

If you’re on a canary build and want to return to the latest stable release:
terminal
bun upgrade --stable

​
Install a specific version

To install a specific version of Bun, use the install script with a version tag:
  • macOS & Linux
  • Windows
terminal
curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3"

​
Package manager users

If you installed Bun via a package manager, use that package manager to upgrade instead of bun upgrade to avoid conflicts.
Homebrew users
To avoid conflicts with Homebrew, use brew upgrade bun instead.Scoop users
To avoid conflicts with Scoop, use scoop update bun instead.

​
See also