> ## Documentation Index
> Fetch the complete documentation index at: https://s2.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the S2 CLI with Homebrew, Cargo, release binaries, or Docker.

<Tabs>
  <Tab title="Homebrew">
    Works on macOS and Linux distributions with [Homebrew](https://brew.sh) installed.

    Homebrew 6.0 and later require explicit [tap trust](https://docs.brew.sh/Tap-Trust) for third-party taps. Installing with the fully qualified name trusts only the S2 formula:

    ```bash theme={null}
    brew install s2-streamstore/s2/s2
    ```

    <Note>
      The fully qualified name (`s2-streamstore/s2/s2`) scopes trust to that formula only. To trust every current and future package in the tap instead, run `brew trust s2-streamstore/s2` before installing.
    </Note>
  </Tab>

  <Tab title="Cargo">
    Works on any system with [Rust](https://www.rust-lang.org/) and [Cargo](https://doc.rust-lang.org/cargo/) installed.

    ```bash theme={null}
    cargo install --locked s2-cli
    ```
  </Tab>

  <Tab title="Release Binaries">
    Linux and macOS users can download the latest release binary:

    ```bash theme={null}
    curl -fsSL s2.dev/install.sh | bash
    ```

    <Note>
      The script installs the binary to `~/.s2/bin` and modifies your shell profile to add it to the path. Reload your shell or open a new terminal after installation.
    </Note>

    See all [releases on GitHub](https://github.com/s2-streamstore/s2/releases).
  </Tab>

  <Tab title="Docker">
    ```bash theme={null}
    docker pull ghcr.io/s2-streamstore/s2
    ```
  </Tab>
</Tabs>

Verify the installation:

```bash theme={null}
s2 --version
```