---
updatedAt: 2026-02-17T11:45:25.000Z
agentTools:
  projectIndex: https://documentation.bunnyshell.com/llms.txt
---

# Install the CLI

The code is [open source on GitHub](https://github.com/bunnyshell/cli).

<br />

## Generic Install: Manual Download from GitHub Releases

Download the appropriate archive for your architecture on the [releases page](https://github.com/bunnyshell/cli/releases).

Then extract the archive, (optionally move the binary to a folder in PATH) and run the binary.

<br />

## macOS: Installing with `brew` or the `installer.sh` script

```shell Homebrew
brew install bunnyshell/tap/bunnyshell-cli
```
```shell Generic Installer
installer=$(curl --silent https://raw.githubusercontent.com/bunnyshell/cli/master/installer.sh) \
    && [ "d2d09e95ea1fdc6cf1ae3750a36bd6aa4fc5b39da85ba9bceefab206ee0a33bb" = "$(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" ] \
    && (
        sh -c "${installer}" || :
    ) \
    || echo "Checksum did not match $(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" \
;
```
```shell Generic Installer in /usr/local/bin
installer=$(curl --silent https://raw.githubusercontent.com/bunnyshell/cli/master/installer.sh) \
    && [ "d2d09e95ea1fdc6cf1ae3750a36bd6aa4fc5b39da85ba9bceefab206ee0a33bb" = "$(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" ] \
    && (
        SUDO_INSTALL=true INSTALL_PATH=/usr/local/bin sh -c "${installer}" || :
    ) \
    || echo "Checksum did not match $(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" \
;
```

<br />

## Linux, macOS with `installer.sh` script

<br />

```shell Generic Installer
installer=$(curl --silent https://raw.githubusercontent.com/bunnyshell/cli/master/installer.sh) \
    && [ "d2d09e95ea1fdc6cf1ae3750a36bd6aa4fc5b39da85ba9bceefab206ee0a33bb" = "$(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" ] \
    && (
        sh -c "${installer}" || :
    ) \
    || echo "Checksum did not match $(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" \
;
```
```shell Generic Installer in /usr/local/bin
installer=$(curl --silent https://raw.githubusercontent.com/bunnyshell/cli/master/installer.sh) \
    && [ "d2d09e95ea1fdc6cf1ae3750a36bd6aa4fc5b39da85ba9bceefab206ee0a33bb" = "$(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" ] \
    && (
        SUDO_INSTALL=true INSTALL_PATH=/usr/local/bin sh -c "${installer}" || :
    ) \
    || echo "Checksum did not match $(printf '%s' "$installer" | openssl dgst -sha256 -r | awk '{print $1}')" \
;
```

<br />

## Windows:

<br />

1. Download the executable file from \[\[<https://github.com/bunnyshell/cli/releases>]].  You'll need to select the file suited to your architecture:
   * bns\_\[version]\_Windows\_x86\_64.zip  (64 bit Windows)
   * bns\_\[version]\_Windows\_arm64.zip (Windows for ARM)
   * bns\_\[version]\_Windows\_i386.zip (For 32 bit Windows)
2. Extract the archive
3. Place the `bns.exe` file in a location of your choice. (For example `C:\Users\Username\bin` - replace `Username` with your actual username)
4. Add the location to your PATH using the command below. ( Replace`C:\Users\Username\bin` with the actual directory where you copied the `bns` binary):

```batch
setx PATH "%PATH%;C:\Users\Username\bin"
```

<br />

<br />

## Installing in a Dockerfile 

If you need the CLI in your images, we recommend using the one from the [official Docker Image](https://hub.docker.com/r/bunnyshell/cli).

```dockerfile Dockerfile
COPY --from=bunnyshell/cli /usr/bin/bns /usr/bin/bns
```

 

## Run in a Docker image

You can also choose to execute it using our [provided Docker image](https://hub.docker.com/r/bunnyshell/cli):

```Text Docker with shared bns authentication
docker run --volume ~/.bunnyshell:/root/.bunnyshell bunnyshell/cli environments list
```

<br />

<Callout icon="👍" theme="okay">
  Next, see how to [Authenticate in the CLI](bunnyshell-cli-authentication).
</Callout>