Configure the boundary.

Public build settings and private runtime configuration have different homes.

Build the static app

Run these commands in the standalone ForgeZero app repository. API_URL is public and compiled into the frontend. Production builds must use an explicit HTTPS origin. Upload the build directory through the repository-owned Cloudflare Pages pipeline.

bash
bun install --frozen-lockfile
APP_MODE=production API_URL=https://api.forgezero.net bun run build:static

Declare the API runtime

The API reads forgezero.runtime.json, or the file named by FZ_CONFIG_PATH. Declare the exact workspace, project, deployment and environment scope, allowed application origins and WebAuthn RP ID. Production startup requires an exact release identity and scoped database, platform-key and email bindings.

Keep secrets on the server

The Agent prompts for JetEmail, Cloudflare and database secrets during interactive bootstrap and persists encrypted systemd fallback credentials. Runtime configuration contains binding metadata, not secret values. Encrypted systemd credentials or exact-scoped Vault aliases deliver secrets to the service. Never set a private credential as a Pages build variable used by client code.