Skip to content

[server]

Addresses Prism listens on for model requests, request limits, browser origins and the optional managed and control listeners.

Key Type Default Description
server.stream_open_keepalive_ms integer 0 Direct Chat SSE comments after upstream HTTP 200 until its first body byte. Off by default; does not apply to buffered v2 acceptance or Responses ingress. Valid range 0. .3600000 ms (config load rejects anything else).
server.host string "127.0.0.1" host is the address the main listener binds for model requests (default 127.0.0.1). The main listener takes no Prism key, so bind a reachable address only on a network you control.
server.port integer 18000 port of the main listener (default 18000). 0 binds a free port and prints it, for test runs.
server.max_request_body_bytes integer 4194304 Use port = 0 only for ephemeral local test runs; Prism will print the actual bound port. reject larger request bodies with invalid_request_size
server.cors_allowed_origins array of string cors_allowed_origins lists browser origins (scheme://host[:port]) that may call the API besides the listener’s own. Empty by default: a page on another origin is refused, so a website cannot spend through Prism.
server.managed_bind string managed_bind optionally starts the credential-authenticated model ingress. Plain HTTP is accepted on loopback and on a tailnet (overlay) address; any other address, wildcard binds included, needs managed_tls_cert and managed_tls_key. Empty is the default and leaves migrations/listeners/legacy bytes inert.
server.managed_tls_cert string managed_tls_cert and managed_tls_key are PEM file paths; set both or neither. With them the managed listener serves TLS on any address. Config load checks only that they come as a pair; the key pair is read when the listener starts, and a pair that does not load keeps the managed listener closed rather than serving plain HTTP.
server.managed_tls_key string managed_tls_cert and managed_tls_key are PEM file paths; set both or neither. With them the managed listener serves TLS on any address. Config load checks only that they come as a pair; the key pair is read when the listener starts, and a pair that does not load keeps the managed listener closed rather than serving plain HTTP.
server.control_bind string control_bind optionally starts a second, loopback-only listener that serves the fail-closed control surface (/prism/traces/{id}, /prism/outcomes, /prism/control, /prism/status, /health). It exists for deployments whose main listener is bound to a non-loopback address (e.g. a tailnet IP): the control endpoints require a loopback remote address, so without this listener they are unreachable even from the host itself. Empty (the default) starts no extra listener and changes nothing. Non-loopback values fail closed at config load: the control surface must never listen on a non-loopback interface. The admin-token requirement is unchanged – loopback is necessary, never sufficient.
server.docs_url string docs_url optionally points at human documentation for this deployment. It is echoed by GET /.well-known/prism.json so an agent that reaches the endpoint can find prose without guessing at external hosts. Empty (the default) omits the link rather than advertising a dead URL.
server.ingress_public_url string ingress_public_url is the address clients on other machines use to reach the model ingress the console publishes (the managed ingress when managed_bind is set, the main listener otherwise): a reverse proxy or a published tunnel in front of the listener. The console shows it on the quick-start page instead of an address derived from the browser. It changes no listener. Empty (the default) lets the console use the host the browser opened it at with the listener’s port.
server.tailscale_socket string tailscale_socket is the tailscaled LocalAPI socket Prism asks which tailnet device a client address belongs to, to name the applications it recognizes from traffic. Empty (the default) tries the standard socket paths; “off” names devices by address only. Nothing else is asked of tailscaled.