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

# Authentication

Authenticating the Lumos CLI

# Authentication

After installation, authenticate with your Lumos account:

```bash theme={null}
# Setup authentication (first time)
lumos setup

# Or login directly via OAuth
lumos login
```

You’ll be directed to authenticate in your browser. Once complete, you can verify your login:

```bash theme={null}
lumos whoami
```

You must use `lumos login` and complete one of the authentication mechanisms before using the CLI. API Tokens last indefinitely. OAuth 2.0 tokens last for 12 hours.

## Authentication issues

If you have trouble logging in:

```bash theme={null}
# Clear existing credentials
lumos logout

# Re-run setup
lumos setup
```