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

# Configuration

> Configure ArgentOS via argent.json and environment variables.

## Configuration File

ArgentOS is configured via `~/.argentos/argent.json`. This file controls the gateway, agent, channels, and all subsystems.

```json theme={null}
{
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  },
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-5-20250929",
      "modelRouter": {
        "enabled": true,
        "tiers": {
          "local": { "model": "qwen3-30b-a3b:latest", "provider": "ollama" },
          "fast": { "model": "claude-haiku-4-5-20251001" },
          "balanced": { "model": "claude-sonnet-4-5-20250929" },
          "powerful": { "model": "claude-opus-4-6" }
        }
      }
    }
  },
  "workspace": "~/argent"
}
```

## State Directory

The canonical state directory is `~/.argentos/`. Key contents:

| Path                 | Description                       |
| -------------------- | --------------------------------- |
| `argent.json`        | Main configuration                |
| `memory.db`          | MemU memory database              |
| `data/dashboard.db`  | Task and dashboard state          |
| `agents/main/agent/` | Agent templates and auth profiles |
| `extensions/`        | Installed plugins                 |

## Environment Variables

| Variable            | Description                                         |
| ------------------- | --------------------------------------------------- |
| `ANTHROPIC_API_KEY` | Fallback API key if auth profiles aren't configured |
| `ARGENT_STATE_DIR`  | Override state directory location                   |
| `ARGENT_WORKSPACE`  | Override agent workspace path                       |

<Tip>
  For the complete reference of all configuration sections and fields, see the [Configuration Reference](/start/config-reference).
</Tip>