Upgrade Bun to the latest version

Upgrade Bun with the built-in bun upgrade command or install a specific version.

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

bun upgrade

bun upgrade downloads and installs the latest release of aphrody-labs/bun, checks it against the release's SHA256SUMS.txt, and replaces the currently installed version. Set APHRODY_BUN_REPO to download releases from another repository.

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

Upgrade to canary builds

bun upgrade --canary installs the release tagged canary. When the repository has no such release, the command reports that no canary build exists.

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:

bun upgrade --stable

Install a specific version

To install a specific version, pass a version or an exact release tag to the install script:

curl -fsSL https://bun.aphrody.app/install.sh | bash -s bun-v1.4.5 ```

</Tab>
<Tab title="Windows">
```powershell PowerShell icon="windows" & ([scriptblock]::Create((irm https://bun.aphrody.app/install.ps1)))
-Version 1.4.5 ```
</Tab>
</Tabs>

---

## Package manager users

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

<Tip>
**npm users** <br />
Use `npm install -g @aphrody/bun-runtime@latest` instead.
</Tip>

---

## See also

- [Installation](/installation) — Install Bun for the first time
- [Update packages](/pm/cli/update) — Update dependencies to latest versions

</div>

</div>