Upgrade Bun to the latest version

Bun can upgrade itself using the built-in bun upgrade command. This is the fastest way to get the latest features and bug fixes.

$ bun upgrade

This downloads and installs the latest stable version of Bun, replacing the currently installed 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+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.

$ 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.5"

> iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.3.5"

Package manager users

If you installed Bun via a package manager, use that package manager to upgrade instead of bun upgrade to avoid conflicts.

See also

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