Runtime
Bundler
Package Manager
Test Runner
Guides
Reference
Blog
Install Bun
Guides Utilities

Upgrade Bun to the latest version

Bun upgrades itself with the built-in bun upgrade command.

terminal
$ bun upgrade

bun 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:

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 released on every commit to the main branch. They're untested, but useful for trying new features or verifying bug fixes before a release.

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:

terminal
$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.14"
PowerShell
> iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.3.14"

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