Environment Variables

5 required | 46 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
`OMNIVERIFIER_API_KEY`	`Optional[str]`	`None`
`OMNIVERIFIER_API_URL`	`str`	`"https://api.omniverifier.com/v1/validate"`
`REACHER_URL`	`Optional[str]`	`None`	http://<kvm8-ip>:8080
`REACHER_HEADER_SECRET`	`Optional[str]`	`None`
`VERIFIER_PROVIDER`	`str`	`"debounce"`
`VERIFIER_HYBRID_DEBOUNCE_DOMAINS`	`str`	`"yahoo.com,aol.com,bellsouth.net,sbcglobal.net,att.net,ymail.com,rocketmail.com"`
`VERIFIER_AB_PERCENT`	`int`	`100`
`VERIFIER_DRY_RUN`	`bool`	`False`
`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`
`INFRA_SLACK_WEBHOOK_URL`	`Optional[str]`	`None`	Infrastructure ops channel (falls back to SLACK_WEBHOOK_URL)
`BILLING_SLACK_WEBHOOK_URL`	`Optional[str]`	`None`	Cheap Inboxes billing audit alerts (#billing)
`BILLING_GMAIL_OAUTH_TOKEN_JSON`	`Optional[str]`	`None`	JSON refresh-token blob from billing_oauth_setup.py
`BILLING_MASTER_SHEET_ID`	`str`	`"1DwPo6Jcvnv96p_8rV5CykRpg7w_4g50ZWrqxR5w57Co"`
`BILLING_MASTER_SHEET_RANGE`	`str`	`"A1:N1000"`
`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
`DATAMOON_CHANNEL_ENABLED`	`bool`	`True`

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

Environment Variables

Required Variables

Optional Variables

Environment Files

On this page