Installation - BunDocumentation Index
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
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main contentBun home pageInstall Bun with npm, Homebrew, Docker, or the official script.
curl -fsSL https://bun.com/install | bash
powershell -c "irm bun.sh/install.ps1|iex"
npm install -g bun # the last `npm` command you'll ever need:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">Bun provides a Docker image that supports both Linux x64 and arm64.Docker
docker pull oven/bun docker run --rm --init --ulimit memlock=-1:-1 oven/bunImage VariantsThere are also image variants for different operating systems:Docker
docker pull oven/bun:debian docker pull oven/bun:slim docker pull oven/bun:distroless docker pull oven/bun:alpineTo 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
Add Bun to your PATH
macOS & Linux Windows:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0" data-component-part="tab-content">1Determine which shell you're using
terminalecho $SHELL # /bin/zsh or /bin/bash or /bin/fish2
Open your shell configuration file
For bash: ~/.bashrc For zsh: ~/.zshrc For fish: ~/.config/fish/config.fish 3Add the Bun directory to PATH
Add this line to your configuration file:terminalexport BUN_INSTALL="$HOME/.bun" export PATH="$BUN_INSTALL/bin:$PATH"4
Reload your shell configuration
terminalsource ~/.bashrc # or ~/.zshrc:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">1
Determine if the bun binary is properly installed
terminal& "$env:USERPROFILE\.bun\bin\bun" --versionIf the command runs successfully but bun --version is not recognized, it means that bun is not in your system’s PATH. To fix this, open a Powershell terminal and run the following command:terminal
[System.Environment]::SetEnvironmentVariable(
"Path",
[System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
[System.EnvironmentVariableTarget]::User
)
2Restart your terminal
After running the command, restart your terminal and test with bun --versionterminalbun --versionUpgrading Once installed, the binary can upgrade itself: terminal
bun upgrade
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 --stableThe 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. Linux & macOS Windows:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0" data-component-part="tab-content">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":first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">On Windows, pass the version number to the PowerShell install script:PowerShell
iex "& {$(irm https:http://bun.com/install.ps1)} -Version 1.3.3"
Direct Downloads
To download Bun binaries directly, visit the releases page on GitHub.
Latest Version Downloads
rm -rf ~/.bun:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">PowerShell
powershell -c ~\.bun\uninstall.ps1:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">npmHomebrewScoop
npm uninstall -g bun
Was this page helpful?
Installation - Bun,AI智能索引,全网链接索引,智能导航,网页索引
- Install Bun with npm, Homebrew, Docker, or the official script.