Upgrade Bun to the latest version
Bun upgrades itself with the built-in bun upgrade command.
bun upgradebun upgrade 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:
bun --version
# Output: 1.x.y
# See the exact commit of the Bun binary
bun --revision
# Output: 1.x.y+abc123defUpgrade to canary builds
Canary builds are released on every commit to the main branch. They’re untested, but useful for trying new features or verifying bug fixes before a release.
bun upgrade --canaryCanary 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:
bun upgrade --stableInstall a specific version
To install a specific version of Bun, use the install script with a version tag:
curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3"Package manager users
If you installed Bun with a package manager, upgrade with that package manager instead of bun upgrade to avoid conflicts.
Homebrew users
Use brew upgrade bun instead.
Scoop users
Use scoop update bun instead.
See also
- Installation — Install Bun for the first time
- Update packages — Update dependencies to latest versions
Was this page helpful?Suggest editsRaise issue