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

# Install the Ravion CLI

> Install the Ravion CLI on macOS and Linux with the official installer, package managers, or a direct binary download for CI environments.

The Ravion CLI (`ravion`) runs on macOS and Linux, on both x86\_64 and arm64.

## Install script

Install the latest release with the install script:

```bash theme={null}
curl -fsSL https://github.com/flightcontrolhq/cli/releases/latest/download/install.sh | sh
```

The script downloads the release archive, verifies its checksum, and installs the `ravion` binary to `/usr/local/bin`.

## Homebrew

On macOS, install with Homebrew:

```bash theme={null}
brew install flightcontrolhq/tap/ravion
```

## Install options

Set environment variables before running the install script to control the install:

| Variable             | Description                                                                 |
| -------------------- | --------------------------------------------------------------------------- |
| `RAVION_VERSION`     | Install a specific version, such as `0.2.0`, instead of the latest release. |
| `RAVION_INSTALL_DIR` | Install directory. Defaults to `/usr/local/bin`.                            |

For example, to install a specific version into a custom directory:

```bash theme={null}
RAVION_VERSION=0.2.0 RAVION_INSTALL_DIR="$HOME/bin" \
  sh -c "$(curl -fsSL https://github.com/flightcontrolhq/cli/releases/latest/download/install.sh)"
```

## Verify the installation

Confirm the CLI is installed and on your `PATH`:

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

## Shell completion

Generate a completion script for your shell with [`ravion shell-completion`](/cli/reference/shell-completion). For example, for zsh:

```bash theme={null}
ravion shell-completion zsh > "${fpath[1]}/_ravion"
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authenticate" icon="key" href="/cli/authentication">
    Sign in and choose your active organization.
  </Card>

  <Card title="Command reference" icon="terminal" href="/cli/overview">
    Browse every CLI command.
  </Card>
</CardGroup>