Reference
Agent configuration
Environment variables used by the database agent.
These settings configure the agent process. They are separate from the API server's environment variables.
| Variable | Default / requirement | Purpose |
|---|---|---|
AVIATO_CONTROL_PLANE_URL | Required | Absolute HTTP(S) control-plane URL. |
AVIATO_AGENT_TOKEN | Required | Deployment credential issued for the environment. |
AVIATO_DATABASE_URL | Required | Main datasource connection string. |
AVIATO_PUBLIC_URL | http://localhost:8080 with the configured port | URL browsers and MCP clients use to reach the agent. Set HTTPS in production. |
PORT | 8080 | Agent listening port. |
AVIATO_DATA_DIR | ./.aviato | Persistent local state directory; mount durable storage. |
AVIATO_DB_SCHEMA | public for PostgreSQL | Schema to expose. |
AVIATO_MONGO_SAMPLE_SIZE | 1000 | Documents sampled per collection for field inference. |
AVIATO_DATASOURCE_<NAME>_URL | Optional | Additional datasource; names are lowercased. main and plugin are reserved. |
AVIATO_DATASOURCE_<NAME>_SCHEMA | public for PostgreSQL | Schema for an additional datasource. |
AVIATO_PLUGIN_URL | Optional | SDK plugin base URL. Requires its matching secret. |
AVIATO_PLUGIN_SECRET | Optional | Signature secret shared with the plugin. Requires its URL. |
AVIATO_DECISIONS_URL | Optional | Self-hosted decision service URL. |
AVIATO_UPLOADS_BUCKET | Optional | Enables uploads to your S3-compatible bucket. |
AVIATO_UPLOADS_PREFIX | aviato/ | Object-key prefix for uploads. |
AVIATO_UPLOADS_PUBLIC_URL | Optional | Public base URL stored for uploaded files. |
AVIATO_UPLOADS_MAX_SIZE_MB | 25 | Per-file size limit. |
Database connection schemes
Supported connection forms include PostgreSQL (postgres:// or postgresql://), MySQL (mysql://), MongoDB (mongodb:// or mongodb+srv://), SQLite (file:), and libSQL (libsql://). MongoDB URLs must include a database name.
Use database privileges to restrict the agent independently of application roles. Protect connection strings and tokens as secrets.
The implementation of this reference is runtime/config.ts.