Skip to content

Environment Variables

Each repo ships an .env.*.example file. Copy and fill in values before running.

django-api

cp .env.development.example .env.development

VariableDescription
DJANGO_SETTINGS_MODULEe.g. config.settings.local
SECRET_KEYDjango secret key
DATABASE_URLMySQL DSN
CELERY_BROKER_URLRedis URL
CELERY_RESULT_BACKENDRedis URL
AWS_ACCESS_KEY_IDS3 credentials
AWS_SECRET_ACCESS_KEYS3 credentials
AWS_STORAGE_BUCKET_NAMES3 bucket
DJANGO_EMAIL_BACKENDEmail backend class (see Mail service)
EMAIL_HOSTSMTP host — mailpit for local/staging, real host for production
EMAIL_PORTSMTP port — 1025 for Mailpit, 587 for TLS
EMAIL_HOST_USERSMTP username (empty for Mailpit)
EMAIL_HOST_PASSWORDSMTP password (empty for Mailpit)
EMAIL_USE_TLSTrue for production SMTP, False for Mailpit
EMAIL_USE_SSLTrue only if provider requires SSL on port 465
SENDGRID_API_KEYRequired only when DJANGO_EMAIL_BACKEND=anymail...sendgrid
CLEARCHECKS_API_KEYBackground check API
RECAPTCHA_SECRET_KEYGoogle ReCaptcha v3
ALLOWED_HOSTSComma-separated hostnames
CORS_ALLOWED_ORIGINSComma-separated SPA origins

portals

cp .env.development.example .env.development

VariableDescription
VITE_API_BASE_URLdjango-api base URL
VITE_RECAPTCHA_SITE_KEYGoogle ReCaptcha v3 site key

testing

cp apps/novahomecare/.env.development.example apps/novahomecare/.env.development

VariableDescription
CYPRESS_BASE_URLPortals SPA URL under test
CYPRESS_API_URLdjango-api URL under test
CYPRESS_ADMIN_EMAIL / _PASSWORDAdmin test credentials
CYPRESS_EMPLOYEE_EMAIL / _PASSWORDEmployee test credentials
CYPRESS_MARKETER_EMAIL / _PASSWORDMarketer test credentials

Never commit secrets

Keep all .env.* files in .gitignore. Use your team's secret manager for sharing credentials.

Nova Home Care — Internal Operational Docs