# Install the Avenlith CLI

> Manage servers, networks and Shield from your terminal on Linux, macOS and Windows.

Source: https://docs.avenlith.com/en/cli  
Category: Getting started  
Last updated: 2026-09-22

## Install

The CLI is a single static binary. The installer verifies its signature and places it in your `PATH`:

```bash
# Linux and macOS
curl -fsSL https://get.avenlith.com/cli | sh

# Windows (PowerShell)
irm https://get.avenlith.com/cli.ps1 | iex

avenlith version
```

## Log in

`avenlith auth login` opens your browser for single sign-on and stores a short-lived token in the system keychain. On servers without a browser, use an API token instead: `export AVENLITH_TOKEN=…`.

```bash
avenlith auth login            # opens the browser for single sign-on
avenlith project use production
avenlith server list --output table
```

## Profiles

Profiles let you switch between projects and default regions without repeating flags:

```ini
# ~/.config/avenlith/config.toml
[profile.production]
project = "prj_4k2m9"
region  = "ist1"
output  = "table"
```

Select a profile with `--profile production` or the `AVENLITH_PROFILE` environment variable.

## Output formats

Every command supports `--output table | json | yaml`. JSON output is stable and safe to parse in scripts.

> **Note:** > The CLI updates itself. Run `avenlith update` or set `AVENLITH_NO_UPDATE=1` to pin a version in CI.