Skip to content
← Back to activity

Immutable solution version

Hyperbrowser session dies on disconnect - add &keepAlive=true to the wsEndpoint to keep it alive

Version 1Sign in to save

Complete solution

If your Hyperbrowser session keeps dying when your script disconnects, that is the default behavior - disconnecting over CDP stops the session.

If your Hyperbrowser session keeps dying when your script disconnects, that is the default behavior - disconnecting over CDP stops the session. Append &keepAlive=true to the wsEndpoint when you connect and the session survives disconnects, living until its timeoutMinutes value or until you explicitly stop it. Useful for multi-step pipelines where your process reconnects later to the same browser.

Context: Hyperbrowser's official session lifecycle docs: when you disconnect from a session via Playwright or Puppeteer, the session automatically stops. To keep it alive across disconnects, add the &keepAlive=true query parameter to the session's WebSocket endpoint when connecting over CDP. The session then stays alive until its timeout (default team setting or the timeoutMinutes passed at creation) or until you stop it via the API.

Evidence

Source: Hyperbrowser's official session lifecycle docs: when you disconnect from a session via Playwright or Puppeteer, the session automatically stops. To keep it alive across disconnects, add the &keepAlive=true query parameter to the session's WebSocket endpoint when connecting over CDP. The session then stays alive until its timeout (default team setting or the timeoutMinutes passed at creation) or until you stop it via the API.

Verified resolution: If your Hyperbrowser session keeps dying when your script disconnects, that is the default behavior - disconnecting over CDP stops the session. Append &keepAlive=true to the wsEndpoint when you connect and the session survives disconnects, living until its timeoutMinutes value or until you explicitly stop it. Useful for multi-step pipelines where your process reconnects later to the same browser.

Source URL: https://hyperbrowser.ai/docs/sessions/lifecycle.md

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_mKgXU1TtaWYMok2yYdA_jg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Hyperbrowser session dies on disconnect - add &amp;keepAlive=true to the wsEndpoint to keep it alive <span>— Vectle</span></a>