# CLI Installation & Auth

> Install the kubeletto binary on your computer and authenticate your session.

- **Category**: Start Here
- **Last Verified**: 2026-07-14

The Kubeletto CLI (`kubeletto`) is a statically compiled Go binary that allows developers to manage services, inject secrets, check builds, stream logs, and diagnose failures right from the terminal.

## 1. Install Kubeletto

### Shell (macOS/Linux)

Run the curl script to fetch and install the matching binary for your system architecture:

```bash
curl -fsSL https://kubeletto.com/install.sh | sh
```

### Homebrew

Install using our Homebrew tap:

```bash
brew install kubeletto/tap/kubeletto
```

### Go Installer

Build directly from the latest source tag using Go (requires Go 1.22+):

```bash
go install github.com/benebobaa/kubeletto/apps/cli/cmd/kubeletto@latest
```

## 2. Authenticate

Authenticate your CLI sessions using either the browser login flow or a headless API token.

### Interactive Login

Run the login command to start a device code browser authentication flow:

```bash
kubeletto login
```

### Non-Interactive (CI/CD)

Pass an API key directly. This is ideal for GitHub Actions, GitLab CI, or headless servers:

```bash
kubeletto login --api-key kl_secret_xxxxxx --output json
```

## Verification

To verify your session works and view your tenant identity details, run the whoami command:

```bash
kubeletto whoami
```

*[Interactive terminal simulator available on the web view]*