Environment Variables
Core and module environment variable reference — ports, gRPC, and readiness tuning.
Every module process
| Variable | Required | Purpose |
|---|---|---|
CONDUIT_SERVER | Yes | Core gRPC address (host:port) |
SERVICE_URL | Yes | This module's reachable address |
GRPC_PORT | No | gRPC bind port (default 5000) |
GRPC_KEY | Production | Shared inter-module secret |
Core / ports
| Variable | Default | Purpose |
|---|---|---|
ADMIN_HTTP_PORT | 3030 | Admin API, /ready, /live, MCP (/mcp) |
CLIENT_HTTP_PORT | 3000 | Client API (router) |
CLIENT_SOCKET_PORT | 3001 | Client WebSockets |
REDIS_HOST / REDIS_PORT | — | Config bus |
Core readiness (READY_*)
Set on the core process. Controls GET /ready deep health evaluation:
| Variable | Default | Purpose |
|---|---|---|
READY_REQUIRED_MODULES | (empty) | Comma-separated modules that must register before ready (Helm sets database or database,router) |
READY_CHECK_REDIS | true | Include Redis PING in readiness |
READY_STRICT | false | Fail readiness when optional modules are not serving |
READY_PROBE_MODULES_ACTIVE | false | Actively gRPC-health-check each module |
READY_TOTAL_TIMEOUT_MS | 3000 | Overall readiness evaluation budget |
READY_REDIS_TIMEOUT_MS | 500 | Redis PING timeout |
READY_MODULE_TIMEOUT_MS | 1000 | Per-module health probe timeout |
Example for a minimal compose stack:
READY_REQUIRED_MODULES=database,router
READY_CHECK_REDIS=trueDatabase module
| Variable | Purpose |
|---|---|
DB_CONN_URI | MongoDB or PostgreSQL connection string |
See Kubernetes and Helm for probe and READY_REQUIRED_MODULES defaults in the official chart, and deployment guides for compose-specific overrides.