Upgrade Bun to the latest version

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

bun upgrade

bun upgrade downloads and installs the latest stable version of Bun, replacing the currently installed version. If you're on a canary build, bun upgrade installs the latest canary build instead.

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+abc123def

Upgrade to canary builds

Canary builds are published automatically from the main branch once a commit's CI tests pass. They're useful for trying new features or verifying bug fixes before a release.

bun upgrade --canary

Switch back to stable

If you're on a canary build and want to return to the latest stable release:

bun upgrade --stable

Install 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"

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.

See also

• Installation — Install Bun for the first time
• Update packages — Update dependencies to latest versions