Overview Bun ships as a single, dependency-free executable. You can install it on macOS, Linux, and Windows via script, package manager, or Docker.
After installation, verify with bun --version and bun --revision.
Installation macOS & Linux
Windows
Package Managers
Docker
curl -fsSL https://bun.com/install | bash
Linux users — The unzip package is required to install Bun. Install it with sudo apt install unzip. Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1. Use uname -r to check your kernel version.
powershell - c "irm bun.sh/install.ps1|iex"
Bun requires Windows 10 version 1809 or higher.
For support and discussion, join our #windows channel on Discord .
Homebrew
npm install -g bun # the last npm command you'll ever need
Bun provides Docker images for Linux x64 and arm64. docker pull oven/bun docker run --rm --init --ulimit memlock=-1:-1 oven/bun
Image variants There are also image variants for different operating systems: docker pull oven/bun:debian docker pull oven/bun:slim docker pull oven/bun:distroless docker pull oven/bun:alpine
To confirm Bun is installed successfully, open a new terminal window and run:
bun --version # Example output: 1.x.y # To see the exact commit of oven-sh/bun you are using bun --revision # Example output: 1.x.y+b7982ac13189
If you have Bun installed but see a command not found error, you may need to manually add the install directory (~/.bun/bin) to your PATH.
Determine which shell you are using
echo $SHELL # Possible outputs: /bin/zsh or /bin/bash or /bin/fish
Open your shell profile
For bash: ~/.bashrc
For zsh: ~/.zshrc
For fish: ~/.config/fish/config.fish
Add the Bun directory to PATH
Add the following to your profile: export BUN_INSTALL = " $HOME /.bun" export PATH = " $BUN_INSTALL /bin: $PATH "
Reload your shell profile
source ~/.bashrc # or ~/.zshrc
Verify the bun executable is installed correctly
& " $env :USERPROFILE\.bun\bin\bun" --version
If that command works, but bun --version is not recognized, then bun is not added to your system PATH. To fix this, open a PowerShell window and run: [System.Environment]::SetEnvironmentVariable( "Path" , [System.Environment] : :GetEnvironmentVariable ( "Path" , "User" ) + "; $env :USERPROFILE\.bun\bin" , [System.EnvironmentVariableTarget] : :User )
Restart your terminal
After running the command, restart your terminal and test bun --version Upgrade Once installed, the binary can self-upgrade:
Homebrew users brew upgrade bun instead.Scoop users 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:
# Upgrade to the latest canary bun upgrade --canary # Switch back to stable bun upgrade --stable
Canary builds are useful for testing new features and bug fixes, and help the Bun team fix issues faster. Canary builds automatically upload crash reports to the Bun team.
Install a specific version Because Bun is a single binary, you can install a specific version by re-running the install script with a version specified.
To install a specific version, pass a git tag to the install script: curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"
On Windows, pass the version number to the PowerShell install script: iex "& { $( irm https: // bun.com / install.ps1 ) } -Version 1.3.3"
Direct downloads To directly download Bun binaries, visit the GitHub releases page .
Latest release downloads Linux x64 Standard Linux x64 binary
Linux x64 Baseline For older CPUs without AVX2
Windows x64 Standard Windows binary
Windows x64 Baseline For older CPUs without AVX2
Windows ARM64 For ARM-based Windows (Snapdragon, etc.)
macOS ARM64 Apple Silicon (M1/M2/M3)
Linux ARM64 ARM64 Linux systems
Musl builds For distributions that don’t support glibc (Alpine Linux, Void Linux, etc.):
If you see errors like bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found, try the musl build. Bun’s
install script automatically picks the right binary for your system.
CPU requirements Bun has different CPU requirements depending on which binary you use:
Standard builds
Baseline builds
x64 binaries target the Haswell CPU architecture (requires AVX and AVX2 instruction sets)Platform Intel Requirement AMD Requirement x64 Haswell (4th gen Core) and newer Excavator and newer
x64-baseline binaries target the Nehalem architecture for older CPUsPlatform Intel Requirement AMD Requirement x64-baseline Nehalem (1st gen Core) and newer Bulldozer and newer
Baseline builds run slower and should only be used if you encounter “Illegal Instruction” errors.
Bun does not support CPUs older than the baseline target, which requires SSE4.2 instruction support. macOS also requires version 13.0 or higher.
Uninstall To remove Bun from your system:
macOS & Linux
Windows
Package Managers
powershell - c ~ / .bun / uninstall.ps1
Homebrew
