The authoritative list is .env.example in the repo root; everything below is grouped by what it configures. Values shown are documented defaults.
Core
| Variable | Controls |
|---|---|
DATABASE_URL | The shared Postgres (quickstart stack: port 5433, dev stack: 5432) |
NATS_URL | NATS JetStream, used to queue ingest and render work |
Retrieval & ingest
| Variable | Controls |
|---|---|
EMBEDDER | fake (deterministic, default) or voyage (voyage-3) |
VOYAGE_API_KEY | Required when EMBEDDER=voyage |
QUERY_LOG_ENABLED | Query logging for analytics |
USAGE_BOOST | Usage-weighted ranking boost on/off |
USAGE_BOOST_WEIGHT | Boost strength (default 0.002) |
Generation
| Variable | Controls |
|---|---|
ANTHROPIC_API_KEY | Model access for assembly gen / make demo |
ASSEMBLY_MODEL | Generation model (default claude-opus-4-8) |
Render farm
| Variable | Controls |
|---|---|
FARM_API_ADDR / FARM_API_URL | The render-farm job API |
FARM_POLL_INTERVAL_MS / FARM_TIMEOUT_MS | Client polling behavior |
MINIO_ENDPOINT / MINIO_ACCESS_KEY / MINIO_SECRET_KEY / MINIO_BUCKET | Artifact storage for screenshots and diffs |
CHROME_BIN | Browser binary for render workers |
RENDER_* / DIFF_* | Render and diff worker tuning |
Telemetry
| Variable | Controls |
|---|---|
TELEMETRY_API_ADDR | Telemetry ingest API |
TELEMETRY_WRITER_ADDR | Telemetry writer |
TELEMETRY_HMAC_SECRETS | Keys for HMAC-signing usage events |
Review UI
| Variable | Controls |
|---|---|
ASSEMBLY_REVIEW_UI_URL | Where the baseline review UI is reachable |
Toolchain
Building from source uses Node ≥ 24, pnpm, Go, uv, and Docker. Exact pinned versions live in CONTRIBUTING.md.