Configuration

Core Environment Variables

Variable	Required	Purpose
DYNAMIC_AGENTS_URL	Yes for chat	Server-side Dynamic Agents URL
MONGODB_URI	Yes for persistence	MongoDB connection string
MONGODB_DATABASE	No	MongoDB database name, default caipe
NEXTAUTH_URL	Yes when auth enabled	Public UI URL for auth callbacks
NEXTAUTH_SECRET	Yes when auth enabled	Session encryption secret
SSO_ENABLED	No	Enable SSO flow
SKIP_AUTH	No	Local development auth bypass
RAG_SERVER_URL	No	RAG backend URL

Local Development

cd ui
npm install

DYNAMIC_AGENTS_URL=http://localhost:8100 \
MONGODB_URI=mongodb://admin:changeme@localhost:27017/caipe?authSource=admin \
NEXTAUTH_URL=http://localhost:3000 \
NEXTAUTH_SECRET=development-secret-change-me \
SKIP_AUTH=true \
npm run dev

Docker Compose

COMPOSE_PROFILES=caipe-ui,dynamic-agents,caipe-mongodb docker compose -f docker-compose.dev.yaml up

The compose files wire DYNAMIC_AGENTS_URL and MONGODB_URI for the packaged services. Override them in .env only when pointing at external services.

Helm

caipe-ui:
  config:
    DYNAMIC_AGENTS_URL: http://ai-platform-engineering-dynamic-agents:8001
    MONGODB_DATABASE: caipe
  existingSecret: caipe-runtime-secrets

existingSecret or externalSecrets should provide sensitive values such as MONGODB_URI, OAuth client secrets, and NEXTAUTH_SECRET.