These variables are validated at startup by backend/libs/config/src/env.schema.ts.

Required

Variable Purpose
NODE_ENV Runtime environment (development, production, etc.)
DATABASE_URL PostgreSQL connection string
JWT_ACCESS_SECRET JWT access token secret
JWT_REFRESH_SECRET JWT refresh token secret
PORT API HTTP port
WORKER_HEALTH_PORT Ingestion worker health HTTP port
MQTT_URL MQTT broker connection string

Optional

Variable Default Purpose
JWT_ACCESS_EXPIRES_IN 24h Access token expiration
JWT_REFRESH_EXPIRES_IN 7d Refresh token expiration
API_PREFIX api/v1 Global API route prefix
LOG_LEVEL info Pino log level
MQTT_CA_PATH (none) CA certificate path for MQTT TLS
MQTT_CERT_PATH (none) Client certificate path for MQTT TLS
MQTT_KEY_PATH (none) Client key path for MQTT TLS