Skip to main content

​
Overview

Vaani uses environment variables for all configuration. Variables are loaded via pydantic-settings with optional .env file support. .env file loading: Automatic in local, dev, and development environments. Disabled in production (use Docker env_file or system env vars).

​
Backend Variables

VariableRequiredExampleDescription
ENV✅localEnvironment: local, dev, stage, prod
LOAD_DOTENV✅1Enable .env file loading
FRONTEND_URL—http://localhost:3000CORS allowed origin
LOG_DIR✅/var/log/vaaniLog file directory
LOG_LEVEL✅INFOLogging level
LOG_RETENTION_DAYS✅30Log file retention
MAX_AGENT_SESSIONS✅10Max concurrent voice calls
CELERY_TIMEZONE✅UTCTimezone for Celery Beat

​
UI Variables

VariableRequiredExampleDescription
NEXT_PUBLIC_ML_BACKEND_URL✅http://localhost:8000Backend API URL
JWT_API_SECRET✅Same as backendJWT secret (must match)
ALLOWED_BOT_ORIGINS—http://localhost:5173Allowed widget origins

​
Security Notes

  • All SecretStr fields are masked in logs and debug output
  • Never commit .env files to version control
  • In production, use Docker env_file directive or platform-native secrets management
  • The JWT_API_SECRET must be identical across backend and UI