# Configuration Reference

Configuration is layered from environment, global user settings, project settings, and active TUI state.

## Common Environment Variables

| Variable | Purpose |
| --- | --- |
| `OMNIUS_HOST` | Bind host and port, for example `0.0.0.0:11435` |
| `OMNIUS_REST_API_KEY` | Single admin bearer token for the Omnius REST API |
| `OMNIUS_REST_API_KEYS` | Multi-key REST auth: `key:scope:owner:rpm:tpd:max_jobs` |
| `OMNIUS_PROVIDER_API_KEY` | Upstream model-provider bearer token |
| `OMNIUS_MODEL_API_KEY` | Alternate upstream model-provider bearer token |
| `OMNIUS_API_KEY` | Legacy fallback for provider auth and legacy REST auth |
| `OMNIUS_API_KEYS` | Legacy multi-key REST auth |
| `OMNIUS_ACCESS` | Network access policy for the daemon |
| `OMNIUS_DAEMON` | Start in daemon mode when set to `1` |
| `OMNIUS_FORCE_NO_THINK` | Force `think: false` for Qwen-style backends |
| `OMNIUS_THINK_AUTO` | Enable opt-in automatic thinking mode trigger |

## Runtime State

Project runtime state:

```text
.omnius/
  settings.json
  jobs/
  context/
  sponsor/
  scoped-personality/
  telegram-creative/
```

User-global state may live under `~/.omnius/`, including runtime API keys and voice clone references.

## Auth Key Format

```text
key:scope:owner:rpm:tpd:max_jobs
```

Scopes:

- `read`
- `run`
- `admin`

Rate and concurrency fields are optional.
