Environment Variables Reference Configure AuthentiVoice behavior through environment variables for different deployment scenarios.
Overview Environment variables allow you to configure AuthentiVoice without modifying code. Set these in your deployment environment, .env files, or container configurations.
Frontend Variables React/Vite application settings
Backend Variables FastAPI server configuration
Database Variables PostgreSQL and Redis settings
Integration Variables Third-party service credentials
Frontend Environment Variables Core Configuration Feature Flags Frontend Examples # Development environment VITE_SUPABASE_URL = https://localhost.supabase.co VITE_SUPABASE_ANON_KEY = eyJ0eXAiOi...dev-key VITE_API_BASE_URL = http://localhost:8000 VITE_API_KEY = dev-api-key VITE_DEMO_ENABLED = true VITE_LOCAL_DEV = true
Backend Environment Variables Core Configuration Database Configuration Storage Configuration AI Service Configuration Google Gemini
OpenAI
Whisper
Security Configuration Integration Environment Variables Supabase Configuration # Required for backend SUPABASE_URL = https://your-project.supabase.co SUPABASE_ANON_KEY = eyJ0eXAiOi...anon-key SUPABASE_SERVICE_KEY = eyJ0eXAiOi...service-key # Optional SUPABASE_JWT_SECRET = your-jwt-secret SUPABASE_DB_URL = postgresql://postgres:password@db.supabase.co:5432/postgres
External Services
# SMTP Configuration SMTP_HOST = smtp.gmail.com SMTP_PORT = 587 SMTP_USER = notifications@authentivoice.com SMTP_PASSWORD = app-specific-password SMTP_FROM_EMAIL = noreply@authentivoice.com SMTP_FROM_NAME = AuthentiVoice SMTP_TLS = true # SendGrid Alternative SENDGRID_API_KEY = SG.actual-api-key SENDGRID_FROM_EMAIL = noreply@authentivoice.com
# Azure AD / OneDrive AZURE_TENANT_ID = your-tenant-id AZURE_CLIENT_ID = your-client-id AZURE_CLIENT_SECRET = your-client-secret ONEDRIVE_REDIRECT_URI = https://app.authentivoice.com/auth/callback
# Webhook Settings WEBHOOK_SECRET = your-webhook-secret WEBHOOK_TIMEOUT = 30 WEBHOOK_MAX_RETRIES = 3 WEBHOOK_RETRY_DELAY = 60
# Sentry Error Tracking SENTRY_DSN = https://key@sentry.io/project-id SENTRY_ENVIRONMENT = production SENTRY_TRACES_SAMPLE_RATE = 0.1 # Datadog APM DD_API_KEY = your-datadog-api-key DD_APP_KEY = your-datadog-app-key DD_SITE = datadoghq.com
Environment File Examples Development Environment # Application APP_NAME = AuthentiVoice-Dev ENVIRONMENT = development DEBUG = true LOG_LEVEL = DEBUG # Database DATABASE_URL = postgresql://dev:devpass@localhost:5432/authentivoice_dev REDIS_URL = redis://localhost:6379/0 # Storage S3_ENDPOINT = http://localhost:9000 S3_ACCESS_KEY = minioadmin S3_SECRET_KEY = minioadmin S3_BUCKET = authentivoice-dev # AI Services GEMINI_API_KEY = dev-gemini-key WHISPER_MODEL = tiny # Security SECRET_KEY = dev-secret-key-not-for-production JWT_SECRET = dev-jwt-secret CORS_ORIGINS = http://localhost:5173,http://localhost:3000
Best Practices Security Best Practices
Never commit .env files to version control
Use different keys for different environments
Rotate secrets regularly
Use secret management services in production
Secret Management Docker Secrets
Kubernetes Secrets
Cloud Providers
# docker-compose.yml services : backend : environment : - DATABASE_URL_FILE=/run/secrets/db_url secrets : - db_url secrets : db_url : file : ./secrets/db_url.txt
# secret.yaml apiVersion : v1 kind : Secret metadata : name : authentivoice-secrets type : Opaque data : database-url : <base64-encoded-value> gemini-api-key : <base64-encoded-value>
# AWS Secrets Manager export DATABASE_URL = $( aws secretsmanager get-secret-value \ --secret-id prod/authentivoice/db \ --query SecretString --output text ) # Azure Key Vault export DATABASE_URL = $( az keyvault secret show \ --name database-url \ --vault-name authentivoice-vault \ --query value -o tsv )
Validation Script #!/bin/bash # validate-env.sh - Validate required environment variables required_vars = ( "VITE_SUPABASE_URL" "VITE_SUPABASE_ANON_KEY" "VITE_API_BASE_URL" "DATABASE_URL" "S3_ENDPOINT" "S3_ACCESS_KEY" "S3_SECRET_KEY" "S3_BUCKET" "GEMINI_API_KEY" ) missing_vars = () for var in "${ required_vars [ @ ]}" ; do if [ -z "${ ! var }" ]; then missing_vars += ( " $var " ) fi done if [ ${ # missing_vars [ @ ]} -ne 0 ]; then echo "❌ Missing required environment variables:" printf '%s\n' "${ missing_vars [ @ ]}" exit 1 else echo "✅ All required environment variables are set" fi
Troubleshooting
Check :
File name is .env (not .env.txt)
File is in correct directory
No spaces around = sign
Quotes for values with spaces
Restart application after changes
Database : Verify DATABASE_URL format and credentials
Redis : Check REDIS_URL and network connectivity
S3 : Confirm endpoint URL and access keys
APIs : Validate API keys and endpoints
Security : Ensure production secrets are properly set
CORS : Verify allowed origins match your domain
SSL : Check HTTPS requirements for APIs
Logging : Set appropriate LOG_LEVEL
Next Steps
Create Environment Files
Set up .env files for each environment
Secure Secrets
Implement proper secret management
Validate Configuration
Run validation scripts before deployment
Document Custom Variables
Keep team documentation updated
