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

# Authentication

> Login, logout, and configure tenant URLs for the Unbound CLI

## Login

**Browser (recommended):**

```bash theme={null}
unbound login
```

**API key** — for CI/CD or headless environments:

```bash theme={null}
unbound login --api-key <your-api-key>
```

**Custom domain:**

```bash theme={null}
unbound login --domain custom.example.com
```

Credentials are stored at `~/.unbound/config.json`.

## Check who you're logged in as

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

Returns your email, organization, and role.

## Logout

```bash theme={null}
unbound logout
```

Removes stored credentials while preserving custom URL settings.

## CLI status

```bash theme={null}
unbound status
```

Shows config file location, login state, and API connectivity. Useful for debugging connection issues.

***

## Tenant / Custom Domains

If your organization runs Unbound on its own hosts — for example `api.acme.com` instead of `api.getunbound.ai` — pass all three URLs at login. They persist to `~/.unbound/config.json`:

```bash theme={null}
unbound login --api-key <YOUR_API_KEY> \
  --gateway-url  https://api.acme.com \
  --frontend-url https://gateway.acme.com \
  --backend-url  https://backend.acme.com
```

Or set them at any time without re-logging in:

```bash theme={null}
# All three at once:
unbound config urls https://api.acme.com https://gateway.acme.com https://backend.acme.com

# One at a time:
unbound config set-gateway-url  https://api.acme.com
unbound config set-frontend-url https://gateway.acme.com
unbound config set-backend-url  https://backend.acme.com
```

View current values:

```bash theme={null}
unbound config show
unbound config show --json
```

### Defaults

| Host                 | Default                         |
| -------------------- | ------------------------------- |
| Gateway (LLM proxy)  | `https://api.getunbound.ai`     |
| Frontend (dashboard) | `https://gateway.getunbound.ai` |
| Backend (CLI API)    | `https://backend.getunbound.ai` |