Server

Environment Variables

Complete reference of Aelio server and SDK environment variables.

Server environment variables

Variable	Purpose	Default
`AELIO_SDK_SECRET`	Shared SDK↔server secret	Required
`AELIO_CONFIG`	Path to config YAML	`config.yaml`
`AELIO_PORT` / `AELIO_SERVER_PORT`	HTTP port	`3010`
`AELIO_MIGRATIONS_PATH`	Drizzle migrations directory	Auto-detected
`AELIO_PUBLIC_PATH`	Static files directory (widget.js)	Auto-detected
`AELIO_TEST_MODE=1`	Enable `/__test__/*` endpoints	Off
`AELIO_DIAGNOSTICS=1`	Enable `/diagnostics` endpoint	Off
`AELIO_REQUIRE_LLM_KEY=1`	Hard-fail without LLM API key	Off
`AELIO_TRUST_PROXY=1`	Trust `x-forwarded-for` for rate limiting	Off
`AELIO_VERSION`	Version string in `/health`	Auto
`NODE_ENV=production`	Stricter production behavior	—

LLM provider keys

Variable	Provider
`OPENAI_API_KEY`	OpenAI LLM + embeddings
`ANTHROPIC_API_KEY`	Anthropic LLM
`GEMINI_API_KEY`	Google Gemini
`GROQ_API_KEY`	Groq
`VOYAGE_API_KEY`	Voyage embeddings (Anthropic profile)

WhatsApp (Meta adapter)

Variable	Purpose
`WA_PHONE_ID`	Meta phone number ID
`WA_TOKEN`	Meta access token
`WA_VERIFY_TOKEN`	Webhook verification token
`WA_APP_SECRET`	HMAC signature verification

Sunjet (optional storage engine)

Variable	Purpose
`SUNJET_API_KEY`	Sunjet ll-server auth
`SUNJET_URL`	Sunjet ll-server URL

SDK environment variables

Variable	Purpose	Alias
`AELIO_SDK_SECRET`	SDK auth secret	`AELIO_SECRET`
`AELIO_SERVER_URL`	WebSocket URL of Aelio server	—

Variable	Purpose
`NEXT_PUBLIC_AELIO_SERVER_URL`	Aelio server HTTP URL (safe for frontend)
`VITE_AELIO_SERVER_URL`	Same, for Vite apps

Only expose the server HTTP URL to the frontend. Never expose AELIO_SDK_SECRET.

Demo project variables (Shopping Testbed)

Variable	Example	Purpose
`DATABASE_URL`	`postgres://aelio:aelio@127.0.0.1:55432/aelio_shop`	Postgres connection
`PORT`	`4173`	App HTTP port
`HOST`	`127.0.0.1`	Bind address
`AELIO_SERVER_URL`	`ws://127.0.0.1:3010`	Aelio runtime WebSocket URL
`AELIO_SECRET`	`change-me-in-production`	SDK auth secret
`AELIO_WIDGET_FILE`	`/path/to/widget.js`	Override widget bundle path

Deployment

Deploy Aelio Server with Docker, Railway, Render, or Fly.io.

Authentication

How authentication works across SDK, server, and widget.

On this page

Server environment variables LLM provider keys WhatsApp (Meta adapter)Sunjet (optional storage engine)SDK environment variables Frontend (widget) environment variables Demo project variables (Shopping Testbed)