Configuration Runbook

Environment Variables

Fulcrum uses Doppler for secret management. The following variables are required in the production environment.

Core Infrastructure

• FULCRUM_ENV: Set to production to enforce strict validation.
• PORT: Service port (default 8080).
• HEALTH_PORT: Health check port (default 8080).

Database

• POSTGRES_CONN_STR: Connection string for the core PostgreSQL database.
• POSTGRES_CONN_STR_METRICS: (Optional) Connection string for the metrics/timescale database.

Messaging

• NATS_URL: NATS connection URL (e.g., nats://nats:4222).
• NATS_STREAM_NAME: JetStream stream name (default FULCRUM_EXECUTION_EVENTS).

Cache

• REDIS_URL: Redis connection URL.

Authentication (Clerk)

• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY: Clerk Public Key.
• CLERK_SECRET_KEY: Clerk Secret Key.

Verification

To verify that the environment is correctly configured, run:

./scripts/verify-env.sh

Doppler Setup

Ensure your local doppler.yaml points to:

setup:
  project: fulcrum
  config: dev