Required destinations
Allow both wildcard domains. Don’t copy a single hostname from a returned
cdp_ws_url, webdriver_ws_url, or browser_live_view_url, because that hostname can change between sessions.443, which omits :8443. Allow both ports during the rollout and use URLs returned by the API without rewriting them.
SDK direct routing
The Node, Python, and Go SDKs send some browser calls straight to the browser instead of throughapi.onkernel.com: curl, computer, playwright, process, fs, logs/stream, telemetry/stream, repl, and webmcp. These calls use the same domains and ports as cdp_ws_url, so a firewall that only allows the API host blocks them.
Change which calls route directly
SetKERNEL_BROWSER_ROUTING_SUBRESOURCES before your program starts.
fs covers every fs/... endpoint.
Content security policy
A network allowlist permits traffic leaving your environment. A Content Security Policy (CSP) permits content loaded by your web application. If you embed Live View or replays, configure both.Live View
Merge these sources into your application’s existing CSP:Replays
Merge these sources into your application’s existingframe-src directive:
Troubleshooting blocked connections
- If API, SDK, or authenticated CLI requests time out, verify access to
api.onkernel.com:443. - If
kernel logindoesn’t complete, verify access toauth.onkernel.com:443anddashboard.onkernel.com:443. - If browser creation succeeds but CDP, WebDriver BiDi, or Live View won’t connect, verify access to both wildcard domains on ports
443and8443. - If Live View loads but remains disconnected or doesn’t show video, verify access to the STUN and TURN destinations.
- If the replay player loads but a recording doesn’t play, verify access to the replay file destination.
- If
process,fs,playwright, orreplcalls time out but browser creation works, allow both wildcard domains on ports443and8443, or setKERNEL_BROWSER_ROUTING_SUBRESOURCES="".