Skip to content

Server settings

Every setting below is read once at startup and requires a restart to change. Built-in defaults are overridden by nonempty environment values. Unknown FANOUT_ names fail startup; platform-injected service names are tolerated. Custom names use FANOUT_ plus a clear name, adding the area only when it clarifies. Vendor credentials and endpoints keep the vendor’s documented names.

Environment variableTypeDefault
FANOUT_ADDRstring127.0.0.1:7520
FANOUT_PPROF_ENABLEDbooleanfalse
FANOUT_PUBLIC_URLstring—
FANOUT_TLS_CERT_FILEstring—
FANOUT_TLS_KEY_FILEstring—
FANOUT_TRUSTED_PROXY_CIDRSstring—

Binds the browser, API, MCP, OTLP/gRPC and OTLP/HTTP listener.

Exposes Go’s net/http/pprof handlers at /debug/pprof/* for CPU/heap/mutex/goroutine profiling under load. Off by default; the routes require an admin browser session with operations:read.

Sets the external browser origin. Required for OIDC; HTTPS is required with MCP.

Selects the TLS certificate file; requires FANOUT_TLS_KEY_FILE.

Selects the TLS private key file; requires FANOUT_TLS_CERT_FILE.

Lists trusted proxy networks, separated by commas; empty trusts no forwarded client addresses.