<Note>
  **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 strongly recommended, but the minimum is 5.1. Use `uname -r` to check Kernel version.
</Note>

<Warning>
  Bun requires Windows 10 version 1809 or later.
</Warning>

For support and discussion, please join the **#windows** channel on our [Discord](https://bun.com/discord).

  ```bash Homebrew icon="https://mintcdn.com/bun-1dd33a4e/nIz6GtMH5K-dfXeV/icons/homebrew.svg?fit=max&auto=format&n=nIz6GtMH5K-dfXeV&q=85&s=5c6dc69e5e0d20fb807fba0a9cd45023" theme={"theme":{"light":"github-light","dark":"dracula"}}
  brew install oven-sh/bun/bun
  ```

  ```bash Scoop icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
  scoop install bun
  ```
</CodeGroup>

```bash Docker icon="docker" theme={"theme":{"light":"github-light","dark":"dracula"}}
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:

```bash Docker icon="docker" theme={"theme":{"light":"github-light","dark":"dracula"}}
docker pull oven/bun:debian
docker pull oven/bun:slim
docker pull oven/bun:distroless
docker pull oven/bun:alpine
```

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

    <Step title="Open your shell configuration file">
      * For bash: `~/.bashrc`
      * For zsh: `~/.zshrc`
      * For fish: `~/.config/fish/config.fish`
    </Step>

    <Step title="Add the Bun directory to PATH">
      Add this line to your configuration file:

      ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
      export BUN_INSTALL="$HOME/.bun"
      export PATH="$BUN_INSTALL/bin:$PATH"
      ```
    </Step>

    <Step title="Reload your shell configuration">
      ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
      source ~/.bashrc  # or ~/.zshrc
      ```
    </Step>
  </Steps>
</Tab>

<Tab title="Windows">
  <Steps>
    <Step title="Determine if the bun binary is properly installed">
      ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
      & "$env:USERPROFILE\.bun\bin\bun" --version
      ```

      If 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:

      ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
      [System.Environment]::SetEnvironmentVariable(
        "Path",
        [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
        [System.EnvironmentVariableTarget]::User
      )
      ```
    </Step>

    <Step title="Restart your terminal">
      After running the command, restart your terminal and test with `bun --version`

      ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
      bun --version
      ```
    </Step>
  </Steps>
</Tab>

bun upgrade

# Upgrade to latest canary
bun upgrade --canary

# Switch back to stable
bun upgrade --stable

```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"
```

```powershell PowerShell icon="windows" theme={"theme":{"light":"github-light","dark":"dracula"}}
iex "& {$(irm https://bun.com/install.ps1)} -Version 1.3.3"
```

| Platform | Intel Requirement               | AMD Requirement    |
| -------- | ------------------------------- | ------------------ |
| x64      | Haswell (4th gen Core) or newer | Excavator or newer |

| Platform     | Intel Requirement               | AMD Requirement    |
| ------------ | ------------------------------- | ------------------ |
| x64-baseline | Nehalem (1st gen Core) or newer | Bulldozer or newer |

<Warning>
  Baseline builds are slower than regular builds. Use them only if you encounter an "Illegal
  Instruction" error.
</Warning>

  ```bash Homebrew icon="https://mintcdn.com/bun-1dd33a4e/nIz6GtMH5K-dfXeV/icons/homebrew.svg?fit=max&auto=format&n=nIz6GtMH5K-dfXeV&q=85&s=5c6dc69e5e0d20fb807fba0a9cd45023" theme={"theme":{"light":"github-light","dark":"dracula"}}
  brew uninstall bun
  ```

  ```bash Scoop icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
  scoop uninstall bun
  ```
</CodeGroup>