Configuration Reference

Steward is configured entirely through environment variables. There is no config file. Pass variables via your orchestrator (docker run -e, Kubernetes Secrets, ECS task definitions, etc.) or a .env file for local development.

Required

Variable	Description
`ENCRYPTION_KEY`	64-character hex string. Used to encrypt provider credentials at rest. Generate with `openssl rand -hex 32`.
`POSTGRES_HOST`	PostgreSQL host.
`POSTGRES_USER`	PostgreSQL user.
`POSTGRES_PASSWORD`	PostgreSQL password.
`POSTGRES_DB`	PostgreSQL database name. Default: `majordomo_steward`.

Server

Variable	Default	Description
`HOST`	`0.0.0.0`	Bind address.
`PORT`	`7680`	HTTP port.
`READ_TIMEOUT`	`30s`	Max duration for reading the full request.
`WRITE_TIMEOUT`	`600s`	Max duration for writing the full response (set high for streaming).
`UPSTREAM_TIMEOUT`	`600s`	Max duration to wait for the upstream LLM provider.

PostgreSQL

Variable	Default	Description
`POSTGRES_PORT`	`5432`	PostgreSQL port.
`POSTGRES_SSLMODE`	`disable`	SSL mode: `disable`, `require`, `verify-full`, etc.
`POSTGRES_MAX_CONNS`	`20`	Connection pool size.

Logging

Variable	Default	Description
`LOG_LEVEL`	`info`	Log verbosity: `debug`, `info`, `warn`, `error`.
`LOG_STORE_REQUEST_BODY`	`false`	Store request bodies in Postgres. Off by default — use cloud storage instead.
`LOG_STORE_RESPONSE_BODY`	`false`	Store response bodies in Postgres. Off by default — use cloud storage instead.

Metadata sync

Variable	Default	Description
`BATCH_INTERVAL`	`60s`	How often Steward syncs usage metadata to Butler.
`BATCH_MAX_SIZE`	`500`	Maximum rows per sync batch.
`KEY_SYNC_INTERVAL`	`5m`	How often Steward polls Butler for API key updates.

Pricing

Variable	Default	Description
`PRICING_REMOTE_URL`	`https://www.llm-prices.com/current-v1.json`	Source for live model pricing. Fetched hourly.
`PRICING_REFRESH_INTERVAL`	`1h`	How often to refresh pricing data.
`PRICING_FALLBACK_FILE`	`./pricing.json`	Local fallback if remote fetch fails.
`PRICING_ALIASES_FILE`	`./model_aliases.json`	Maps provider model names to canonical pricing names.

Provider overrides

Override the base URL for any LLM provider. Useful when routing through an internal gateway or private endpoint.

Variable	Default
`OPENAI_BASE_URL`	`https://api.openai.com`
`ANTHROPIC_BASE_URL`	`https://api.anthropic.com`
`GEMINI_BASE_URL`	`https://generativelanguage.googleapis.com`

Admin API

Variable	Default	Description
`STEWARD_ADMIN_TOKEN`	—	When set, enables the admin API for managing org registration and checking sync status.

Secrets management

Set ENCRYPTION_KEY and POSTGRES_PASSWORD via your secrets manager — never in source control. In Kubernetes, mount them as Secrets. In ECS, reference them from Parameter Store or Secrets Manager. In Docker, use an .env file outside of version control.

Getting Started

How It Works

Connect Your Code

Track & Analyze

Control

Enterprise

Reference

Configuration Reference

Required

Server

PostgreSQL

Logging

Metadata sync

Pricing

Provider overrides

Admin API

Secrets management

​Required

​Server

​PostgreSQL

​Logging

​Metadata sync

​Pricing

​Provider overrides

​Admin API

​Secrets management

Required

Server

PostgreSQL

Logging

Metadata sync

Pricing

Provider overrides

Admin API

Secrets management