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.

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.

aios config show
aios config validate

​Configuration Reference

​Current Bootstrap/Server Runtime Config

​Global Configuration

​Infrastructure Configuration

​Agent Configuration

​Planned CLI Validation Commands (Not Yet Implemented)

​Related Pages