Skip to main content

​
Overview

Bun ships as a single, dependency-free executable. You can install it via script, package manager, or Docker across macOS, Linux, and Windows.
After installation, verify with bun --version and bun --revision.

​
Installation

curl -fsSL https://bun.com/install | bash
Linux users  The unzip package is required to install Bun. Use sudo apt install unzip to install the unzip package. Kernel version 5.6 or higher is recommended; Bun runs on kernels as old as 3.10 (RHEL 7) with graceful degradation of newer syscalls. Use uname -r to check your kernel version.
To check that Bun was installed successfully, open a new terminal window and run:
terminal
bun --version
# Output: 1.x.y

# See the precise commit of `oven-sh/bun` that you're using
bun --revision
# Output: 1.x.y+b7982ac13189
If you’ve installed Bun but are seeing a command not found error, you may have to manually add the installation directory (~/.bun/bin) to your PATH.
1

Determine which shell you're using

terminal
echo $SHELL
# /bin/zsh  or /bin/bash or /bin/fish
2

Open your shell configuration file

  • For bash: ~/.bashrc
  • For zsh: ~/.zshrc
  • For fish: ~/.config/fish/config.fish
3

Add the Bun directory to PATH

Add this line to your configuration file:
terminal
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
4

Reload your shell configuration

terminal
source ~/.bashrc  # or ~/.zshrc

​
Upgrading

Once installed, the binary can upgrade itself:
terminal
bun upgrade
Homebrew users
To avoid conflicts with Homebrew, use brew upgrade bun instead.Scoop users
To avoid conflicts with Scoop, use scoop update bun instead.

​
Canary Builds

-> View canary build Bun automatically releases an (untested) canary build on every commit to main. To upgrade to the latest canary build:
terminal
# Upgrade to latest canary
bun upgrade --canary

# Switch back to stable
bun upgrade --stable
The canary build is useful for testing new features and bug fixes before they’re released in a stable build. To help the Bun team fix bugs faster, canary builds automatically upload crash reports to Bun’s team.

​
Installing Older Versions

Since Bun is a single binary, you can install older versions by re-running the installer script with a specific version.
To install a specific version, pass the git tag to the install script:
terminal
curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"

​
Direct Downloads

To download Bun binaries directly, visit the releases page on GitHub.

​
Latest Version Downloads

https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/linux.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=f45928d13c067bfd53a41fb7c0860fff

Linux x64

Standard Linux x64 binary
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/linux.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=f45928d13c067bfd53a41fb7c0860fff

Linux x64 Baseline

For older CPUs without AVX2
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/windows.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=c1e6c9fd5641fcc457e95413202af191

Windows x64

Standard Windows binary
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/windows.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=c1e6c9fd5641fcc457e95413202af191

Windows x64 Baseline

For older CPUs without AVX2
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/windows.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=c1e6c9fd5641fcc457e95413202af191

Windows ARM64

Windows on ARM (Snapdragon, etc.)
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/apple.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=eeb6d9360a2dc50a9df88bdb002fd768

macOS ARM64

Apple Silicon (M1/M2/M3)
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/apple.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=eeb6d9360a2dc50a9df88bdb002fd768

macOS x64

Intel Macs
https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/linux.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=f45928d13c067bfd53a41fb7c0860fff

Linux ARM64

ARM64 Linux systems

​
Musl Binaries

For distributions without glibc (Alpine Linux, Void Linux):
Bun’s glibc binaries require glibc 2.17 or newer. If you encounter an error like bun: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_... not found, try using the musl binary. Bun’s install script automatically chooses the correct binary for your system.

​
CPU Requirements

Bun has specific CPU requirements based on the binary you’re using:
x64 binaries target the Haswell CPU architecture (AVX and AVX2 instructions required)
PlatformIntel RequirementAMD Requirement
x64Haswell (4th gen Core) or newerExcavator or newer
Bun does not support CPUs older than the baseline target, which mandates the SSE4.2 extension. macOS requires version 13.0 or later.

​
Uninstall

To remove Bun from your system:
terminal
rm -rf ~/.bun