---
sidebar_position: 40
---

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

# `lium init`

Run first-time setup: authenticate in the browser, then save your API key and configure your SSH key locally.

```bash
lium init [OPTIONS]
```

By default `lium init` opens your browser to authenticate. For headless machines, use the two-step flow with `--no-browser` and `--session`.

## Options

| Flag | Effect |
|------|--------|
| `--no-browser` | Print the auth URL and a session ID instead of opening a browser (step 1 of headless auth) |
| `--session ID` | Verify a pending auth session and save the API key (step 2 of headless auth) |

## Examples

```bash
lium init                       # Opens the browser to authenticate
lium init --no-browser          # Prints the auth URL + session ID
lium init --session <ID>        # Verifies that session and saves the API key
```

## See also

- [Installation](../installation) — install the CLI first
- [`lium config`](./config) — read/write individual config values later