Install Server

export AELIO_SDK_SECRET=change-me-in-production
export OPENAI_API_KEY=sk-...        # optional
pnpm --filter @aelio/server dev

Server starts on http://localhost:3010.

docker run -p 3010:3010 \
  -e AELIO_SDK_SECRET=your-secret \
  -e OPENAI_API_KEY=sk-... \
  -e AELIO_CONFIG=/config/config.docker.yaml \
  -v $(pwd)/config.docker.yaml:/config/config.docker.yaml \
  aelio/server:latest

Single-container, ~190MB distroless image.

cd aelio
pnpm install && pnpm build
docker build -t aelio/server:latest -f server/Dockerfile .

Configuration

Point to a config profile:

AELIO_CONFIG=/path/to/config.yaml pnpm --filter @aelio/server dev

Profile	Purpose
`config.yaml`	Local dev (OpenAI, mock WhatsApp)
`config.docker.yaml`	Docker deployment
`config.anthropic.yaml`	Anthropic + Voyage embeddings
`config.gemini.yaml`	Gemini
`config.proactive.yaml`	Proactive messaging enabled

Verify server is running

curl http://localhost:3010/health
# {"status":"ok","version":"0.1.0"}

curl http://localhost:3010/ready
# {"status":"ready","checks":{...}}

Deploy templates

Ready-made templates in the repo for Railway, Render, and Fly.io:

server/deploy/railway/
server/deploy/render/
server/deploy/fly/

See Server deployment for production checklist.

Configuration

Verify server is running

Deploy templates

On this page