Skip to content

Configuration

Backend settings load from backend/.env with the FS_ prefix (Pydantic Settings). Core variables — mostly generated by init.py:

  • FS_APP_NAME — application name
  • FS_MODE — b2c or b2b (see Multi-Tenancy)
  • FS_ENVIRONMENT — dev, beta, or prod
  • FS_DB_URL / FS_DB_SCHEMA — database connection
  • FS_BASE_WEB_URL / FS_BASE_API_URL — frontend and backend URLs
  • FS_JWT_SECRET_KEY / FS_CRON_SECRET — auto-generated secrets

See the .env.example in each directory (backend/, frontend/, landing/, backend/db/) for the full list.

Environment

FS_ENVIRONMENT="dev"        # dev | beta | prod — affects cookies, CORS, and defaults
FS_BASE_WEB_URL="http://localhost:5173"
FS_BASE_API_URL="http://localhost:8000"

CORS origins are derived per environment in backend/app/config/settings.py (cors_origins). Cookie security (Secure, SameSite) tightens automatically outside dev — see Security.

Background jobs (cron)

Session cleanup and other scheduled work run via the cron endpoints, authenticated with a shared secret:

FS_CRON_SECRET="your-secure-cron-secret"
FS_CRON_SESSION_RETENTION_DAYS=7

Integrations

Provider setup lives with each feature: Email, Billing & Subscriptions, Google OAuth, and AI.