# Agent configuration (https://docs.getaviato.com/reference/agent-configuration)



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 [#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](https://github.com/getaviato/aviato/blob/master/packages/agent-core/src/runtime/config.ts).