Launch your first cloud browser.

Connect Playwright to Browserherd, open a page, and close the session when your work is complete. The same connection pattern works from local development, a worker, or CI.

1. 1

   Create an API key

   Open the Browserherd dashboard, select your project, and choose API key. Copy the key and store it in an environment variable.

   .ENV▢ Copy

   BROWSERHERD_API_KEY=bh_live_your_project_key

2. 2

   Install Playwright Core

   Use playwright-core when connecting to an existing cloud browser. It does not download a local browser binary.

   TERMINAL▢ Copy

   npm install playwright-core

3. 3

   Connect to Browserherd

   Build the WebSocket endpoint from your API key and session options, then connect over the Chrome DevTools Protocol.

   QUICKSTART.JS▢ Copy

   import { chromium } from "playwright-core";
   
   const query = new URLSearchParams({
     token: process.env.BROWSERHERD_API_KEY,
     sessionName: "quickstart",
     sessionTTL: "900",
     sessionRecording: "true",
     region: "us-east-1"
   });
   
   const endpoint = `wss://connect.browserherd.com?${query}`;
   const browser = await chromium.connectOverCDP(endpoint);
   
   const context = browser.contexts()[0];
   const page = await context.newPage();
   await page.goto("https://example.com", {
     waitUntil: "domcontentloaded"
   });
   
   console.log(await page.title());
   await browser.close();

   Closing the browser ends the cloud session and stops usage.
4. 4

   Run the script

   TERMINAL▢ Copy

   node quickstart.js

   The terminal prints Example Domain. The completed session also appears in Dashboard → History with its duration, status, region, and recording.