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:

macOS & Linux
Windows

terminal

curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3"

PowerShell

iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.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.

​Verify the upgrade

​Upgrade to canary builds

​Switch back to stable

​Install a specific version

​Package manager users

​See also

Verify the upgrade

Upgrade to canary builds

Switch back to stable

Install a specific version

Package manager users

See also