Environments¶
The system runs on EPFL OpenShift, delivered by ArgoCD from the
openshift-app-config GitOps repo.
Dev / Stage / Prod Topology¶
| Environment | URL | Purpose | Secrets Management |
|---|---|---|---|
| Local | http://localhost:3000 | Individual development | .env files |
| Development | https://co2-calculator-dev.epfl.ch/ | Team collaboration | Infisical, External Secrets |
| Staging | https://co2-calculator-stage.epfl.ch/ | Pre-release testing | Infisical, External Secrets |
| Production | https://co2-calculator.epfl.ch/ | Live user traffic | Infisical, External Secrets |
Production (co2-calculator.epfl.ch) goes live with v1.0.0
(2026-06-17); until then it serves as the pre-release/validation
instance. For local setup, see the Development Guide.
Secrets Management¶
- Local —
.envfiles from.env.exampletemplates (never committed); separatebackend/.envandfrontend/.env. - Dev / Stage / Prod — the External Secrets Operator pulls every key under
/epfl/co2-calculatorfrom Infisical into Kubernetes Secrets, injected as pod environment variables. Details: Infrastructure Overview.
Database¶
A single managed PostgreSQL (EPFL DBaaS) per environment, reached over
DB_URL. Connection pooling is in-process (SQLAlchemy async) behind a
DBaaS-side PgBouncer on every instance since 2026-09 (see the
database overview); there is no read
replica. A db-dump CronJob backs each
database up to the db-dumps PVC. Local development uses Postgres 18 in
Docker Compose.
Background Jobs¶
Background jobs run in-process within the backend pods and scale with the web replicas; there is no separate Redis/Celery tier (see ADR-010).
Key Environment Variables¶
| Variable | Purpose | Required |
|---|---|---|
DB_URL |
PostgreSQL connection string | Yes |
JWT_HMAC_KEY |
JWT signing key | Yes |
SESSION_HMAC_KEY |
OAuth-flow session cookie signing key | Yes |
OAUTH_CLIENT_ID / OAUTH_CLIENT_SECRET |
Entra ID / OIDC client credentials | Yes |
OAUTH_ISSUER_URL |
OIDC issuer (well-known config appended) | Yes |
S3_ENDPOINT_HOSTNAME / S3_BUCKET / S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEY |
EPFL S3 file storage (else local disk) | No |
APP_SENTRY_DSN |
GlitchTip/Sentry DSN (frontend errors) | No |
APP_MATOMO_URL |
Matomo analytics endpoint | No |
APP_MATOMO_SITE_ID |
Matomo site id (empty = tracking off) | No |
APP_DEMO_MODE |
true = block app, link to prod |
No |
APP_PRODUCTION_URL |
Prod URL shown in demo mode | No |
ENVIRONMENT |
Environment name | Yes |
Complete lists live in the .env.example files.
For detailed infrastructure information, see Infrastructure Documentation.