Environment Variables
Every environment variable with types, defaults, and descriptions
5 required | 32 optional
Required Variables
The application will fail to start without these.
| Variable | Type | Description |
|---|---|---|
SUPABASE_URL | str | |
SUPABASE_KEY | str | Anon key |
SUPABASE_SERVICE_ROLE_KEY | str | |
XPRESSDOCS_USERNAME | str | |
XPRESSDOCS_PASSWORD | str |
Optional Variables
| Variable | Type | Default | Description |
|---|---|---|---|
API_HOST | str | "0.0.0.0" | |
API_PORT | int | 8000 | |
API_RELOAD | bool | True | |
API_V1_PREFIX | str | "/api/v1" | |
SUPABASE_JWT_SECRET | Optional[str] | None | JWT secret for token verification |
REDIS_BROKER_URL | str | "redis://localhost:6379/0" | |
REDIS_BACKEND_URL | str | "redis://localhost:6379/0" | |
DEBOUNCE_API_KEY | Optional[str] | None | |
DEBOUNCE_RATE_LIMIT | int | 10 | Requests per minute (adjust based on your plan) |
DEBOUNCE_BULK_UPLOAD_URL | str | "https://bulk.debounce.io/v1/upload/" | |
DEBOUNCE_BULK_STATUS_URL | str | "https://bulk.debounce.io/v1/status/" | |
DEBOUNCE_BULK_THRESHOLD | int | 50 | Switch to bulk API when batch > this size |
DEBOUNCE_BULK_MAX_BATCH_SIZE | int | 200000 | Max emails per upload |
DEBOUNCE_BULK_POLL_INTERVAL | int | 10 | Seconds between status checks |
DEBOUNCE_BULK_TIMEOUT | int | 21600 | 6 hours max wait for large batches |
USE_BULK_VERIFICATION | bool | True | Enable bulk verification for large batches |
EMAIL_BISON_API_URL | str | "https://send.maverickmarketingllc.com/api" | |
EMAIL_BISON_API_KEY | Optional[str] | None | |
EMAIL_BISON_WORKSPACE_ID | Optional[str] | None | Default workspace ID |
SLACK_WEBHOOK_URL | Optional[str] | None | |
SECRET_KEY | str | "" | Must be set from environment, no default |
ALGORITHM | str | "HS256" | |
ACCESS_TOKEN_EXPIRE_MINUTES | int | 30 | |
ENVIRONMENT | str | "development" | |
ALLOWED_ORIGINS | str | "http://localhost:3000,http://localhost:3001" | |
WEBHOOK_SECRET | str | "" | Secret for webhook signature validation |
CSV_FIELD_SIZE_LIMIT_BYTES | int | "1024 * 1024" | 1MB per field |
SENTRY_DSN | Optional[str] | None | |
VERSION | str | "1.0.0" | |
MASTER_CONTACTS_API_URL | Optional[str] | None | |
MASTER_CONTACTS_API_KEY | Optional[str] | None | |
MASTER_CONTACTS_ENABLED | bool | False | Set to True when master contacts service is ready |
Environment Files
| File | Purpose | In Git? |
|---|---|---|
backend/.env | Local development | No |
backend/.env.production | Production (server-local) | No |
backend/.env.beta | Beta (server-local) | No |
frontend/apps/dashboard/.env.local | Local frontend | No |
frontend/apps/dashboard/.env.production | Production frontend | No |
frontend/apps/dashboard/.env.beta | Beta frontend | No |