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

# Installation

> Install the Plerion CLI on macOS, Linux, or Windows.

With the **[Plerion CLI](https://github.com/plerionhq/plerion-cli)**, you can interact with the Plerion platform from your terminal. Pre-built binaries are available for all major platforms.

***

## Install script (recommended)

The install script auto-detects your OS and architecture, downloads the correct binary, and places it in `/usr/local/bin`:

```bash theme={"system"}
curl -fsSL https://raw.githubusercontent.com/plerionhq/plerion-cli/main/install.sh | sh
```

To install a specific version or to a custom directory:

```bash theme={"system"}
VERSION=v0.1.6 INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/plerionhq/plerion-cli/main/install.sh | sh
```

***

## From GitHub releases

Download the latest binary for your platform from [Releases](https://github.com/plerionhq/plerion-cli/releases):

| Platform              | Binary                       |
| --------------------- | ---------------------------- |
| macOS (Apple Silicon) | `plerion-macos-arm64`        |
| macOS (Intel)         | `plerion-macos-x86_64`       |
| Linux x86\_64         | `plerion-linux-x86_64`       |
| Linux ARM64           | `plerion-linux-arm64`        |
| Windows x64           | `plerion-windows-x86_64.exe` |

<Tabs>
  <Tab title="macOS (Apple Silicon)">
    ```bash theme={"system"}
    curl -L -o plerion https://github.com/plerionhq/plerion-cli/releases/latest/download/plerion-macos-arm64
    chmod +x plerion
    sudo mv plerion /usr/local/bin/
    ```

    <Warning>
      macOS may block unsigned binaries downloaded outside the App Store. If you see a Gatekeeper warning, remove the quarantine attribute:

      ```bash theme={"system"}
      xattr -d com.apple.quarantine /usr/local/bin/plerion
      ```
    </Warning>
  </Tab>

  <Tab title="macOS (Intel)">
    ```bash theme={"system"}
    curl -L -o plerion https://github.com/plerionhq/plerion-cli/releases/latest/download/plerion-macos-x86_64
    chmod +x plerion
    sudo mv plerion /usr/local/bin/
    ```

    <Warning>
      macOS may block unsigned binaries downloaded outside the App Store. If you see a Gatekeeper warning, remove the quarantine attribute:

      ```bash theme={"system"}
      xattr -d com.apple.quarantine /usr/local/bin/plerion
      ```
    </Warning>
  </Tab>

  <Tab title="Linux x86_64">
    ```bash theme={"system"}
    curl -L -o plerion https://github.com/plerionhq/plerion-cli/releases/latest/download/plerion-linux-x86_64
    chmod +x plerion
    sudo mv plerion /usr/local/bin/
    ```
  </Tab>

  <Tab title="Linux ARM64">
    ```bash theme={"system"}
    curl -L -o plerion https://github.com/plerionhq/plerion-cli/releases/latest/download/plerion-linux-arm64
    chmod +x plerion
    sudo mv plerion /usr/local/bin/
    ```
  </Tab>

  <Tab title="Windows">
    Download `plerion-windows-x86_64.exe` from the [releases page](https://github.com/plerionhq/plerion-cli/releases) and add it to your `PATH`.
  </Tab>
</Tabs>

Verify the installation:

```bash theme={"system"}
plerion --help
```

***

## From source

Requires Rust 1.70+ and Cargo:

```bash theme={"system"}
git clone git@github.com:plerionhq/plerion-cli.git
cd plerion-cli
cargo build --release
cp target/release/plerion /usr/local/bin/
```