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

# Configuration Reference

> Key AiOS platform and Agent-access configuration fields, defaults, and recommended ranges.

# Configuration Reference

This page summarizes commonly used AiOS configuration fields for deployment, tuning, and troubleshooting.

## Current Bootstrap/Server Runtime Config

The current `go run ./cmd/aios` entry actually reads only the following runtime settings:

| Key                | Environment Variable     | Default     | Description                                                    |
| ------------------ | ------------------------ | ----------- | -------------------------------------------------------------- |
| `server.address`   | `AIOS_SERVER__ADDRESS`   | `:8080`     | HTTP listen address                                            |
| `server.log_level` | `AIOS_SERVER__LOG_LEVEL` | `info`      | `slog` log level                                               |
| `runtime.mode`     | `AIOS_RUNTIME__MODE`     | `bootstrap` | Current runtime mode; only `bootstrap` may start without a DSN |
| `postgres.dsn`     | `AIOS_POSTGRES__DSN`     | empty       | PostgreSQL connection string; required in `dev/prod/...` modes |

If you want local development to run against external state, follow [Local PostgreSQL Development Setup](/en/getting-started/local-postgres-dev).

## Global Configuration

| Key         | Description         | Default   | Recommendation                                                     |
| ----------- | ------------------- | --------- | ------------------------------------------------------------------ |
| `profile`   | Runtime profile set | `default` | Split by `dev/staging/prod`                                        |
| `output`    | CLI output format   | `table`   | Use `json` for automation                                          |
| `log.level` | Log verbosity       | `info`    | Keep `info` in production, use `debug` temporarily for diagnostics |

## Infrastructure Configuration

| Key                      | Description            | Default   | Recommendation                    |
| ------------------------ | ---------------------- | --------- | --------------------------------- |
| `infra.namespace`        | Default namespace      | `default` | Isolate namespaces by environment |
| `infra.replicas`         | Default replicas       | `1`       | Start from `2` in production      |
| `infra.resources.cpu`    | CPU requests/limits    | none      | Always define requests and limits |
| `infra.resources.memory` | Memory requests/limits | none      | Tune from load test data          |

## Agent Configuration

| Key                    | Description                         | Default | Recommendation                   |
| ---------------------- | ----------------------------------- | ------- | -------------------------------- |
| `agent.maxConcurrency` | Max concurrent agents per workspace | `2`     | Increase gradually with capacity |
| `agent.defaultTool`    | Default execution tool              | none    | Set per task archetype           |
| `agent.timeout`        | Per-task timeout                    | `30m`   | Raise for long-running jobs      |

## Planned CLI Validation Commands (Not Yet Implemented)

The repository does not currently ship these `config` subcommands. The configuration semantics on this page remain shared direction for future CLI and API surfaces.

```bash theme={null}
aios config show
aios config validate
```

## Related Pages

* [Platform Overview](/en/platform/index)
* [Application Delivery Overview](/en/platform/application-delivery)
* [Local PostgreSQL Development Setup](/en/getting-started/local-postgres-dev)
* [CLI Reference](/en/reference/cli-reference)