Environment Variables
Complete reference for all environment variables used by Flo. Configure these in your .env file.
Database
| Variable | Required | Description |
|---|---|---|
DB_NAME | Yes | PostgreSQL database name |
DB_USER | Yes | PostgreSQL username |
DB_PASSWORD | Yes | PostgreSQL password |
DB_CONNECTION_STRING | Yes | Full connection string (overrides individual vars) |
Connection string format:
Host=<IP>;Port=<PORT>;Database=<DB>;Username=<USER>;Password=<PASS>;SSL Mode=Disable
Authentication
| Variable | Required | Description |
|---|---|---|
JWT_ISSUER | Yes | Token issuer URL (e.g., https://api.yourdomain.com) |
JWT_AUDIENCE | Yes | Token audience URL |
COOKIE_DOMAIN | Yes | Cookie domain for cross-subdomain auth (e.g., .yourdomain.com) |
OIDC_SIGNING_CERT_PATH | For OIDC | Path to OpenIddict signing certificate (.pfx) |
OIDC_SIGNING_CERT_PASSWORD | For OIDC | Signing certificate password |
OIDC_ENCRYPTION_CERT_PATH | For OIDC | Path to encryption certificate (.pfx) |
OIDC_ENCRYPTION_CERT_PASSWORD | For OIDC | Encryption certificate password |
Email
| Variable | Required | Description |
|---|---|---|
EMAIL_SENDER_EMAIL_PROVIDER | Yes | Provider name: Gmail, Cloudflare, Smtp |
EMAIL_SENDER_EMAIL_USERNAME | Yes | SMTP username / Gmail account |
EMAIL_SENDER_EMAIL_ALIAS | No | Public-facing sender address |
EMAIL_SENDER_EMAIL_PSW | Yes | SMTP password / App Password |
Application URLs
| Variable | Required | Description |
|---|---|---|
FLO_APP_URL | Yes | Backend API URL (e.g., https://api.yourdomain.com) |
FE_APP_URL | Yes | Frontend URL (e.g., https://app.yourdomain.com) |
ASPNETCORE_ENVIRONMENT | Yes | Production or Development |
Branding & Whitelabeling
| Variable | Required | Description |
|---|---|---|
FORCE_RESPIRASTUDIO_UI | No | Force Respirastudio brand theme (true/false) |
FLO_CUSTOMER_NAME_IT | No | Customer display name in Italian (for emails/UI) |
FLO_CUSTOMER_NAME_EN | No | Customer display name in English |
Strapi CMS Integration
| Variable | Required | Description |
|---|---|---|
STRAPI_ENABLED | No | Enable Strapi integration (true/false) |
STRAPI_BASE_URL | If enabled | Strapi API URL |
STRAPI_API_KEY | If enabled | Strapi API token |
Frontend (Angular)
These are configured in Flo.FE/src/environments/environment.ts:
| Property | Description |
|---|---|
production | Production mode flag |
baseUrl | Backend API URL |
forceRespirastudioUI | Force Respirastudio theme |
strapiEnabled | Enable Strapi CMS integration |
strapiBaseUrl | Strapi API URL |
canTranslateUI | Show language switcher |
fixedLanguage | Lock to specific language (for whitelabel) |
Example .env File
# Database
DB_NAME=flo
DB_USER=flo_user
DB_PASSWORD=secure_password
DB_CONNECTION_STRING=Host=db;Port=5432;Database=flo;Username=flo_user;Password=secure_password;
# Auth
JWT_ISSUER=https://api.yourdomain.com
JWT_AUDIENCE=https://api.yourdomain.com
COOKIE_DOMAIN=.yourdomain.com
# Email
EMAIL_SENDER_EMAIL_PROVIDER=Cloudflare
EMAIL_SENDER_EMAIL_USERNAME=newsletter
EMAIL_SENDER_EMAIL_ALIAS=newsletter@yourdomain.com
EMAIL_SENDER_EMAIL_PSW=smtp_password
# URLs
FLO_APP_URL=https://api.yourdomain.com
FE_APP_URL=https://app.yourdomain.com
ASPNETCORE_ENVIRONMENT=Production
# Branding
FLO_CUSTOMER_NAME_IT=Il Tuo Studio
FLO_CUSTOMER_NAME_EN=Your Studio
See .env.example in the repository for the most up-to-date reference.