Skip to main content
Add these destinations to your allowlist when a firewall, proxy, or sandbox restricts outbound traffic. You don’t need to open inbound ports. Allow only the destinations used by your integration. Apply the Live View and replay rules to each viewer’s network, not just the machine running your agent.

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.
Browser URLs are moving to port 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 through api.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

Set KERNEL_BROWSER_ROUTING_SUBRESOURCES before your program starts.
Entries match whole path segments, so 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 existing frame-src directive:

Troubleshooting blocked connections

  • If API, SDK, or authenticated CLI requests time out, verify access to api.onkernel.com:443.
  • If kernel login doesn’t complete, verify access to auth.onkernel.com:443 and dashboard.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 443 and 8443.
  • 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, or repl calls time out but browser creation works, allow both wildcard domains on ports 443 and 8443, or set KERNEL_BROWSER_ROUTING_SUBRESOURCES="".