Skip to content

Install

Option A: Patch an existing Puppeteer or Playwright install (CLI patcher)

Run the patcher against your already-installed package. No permanent package change needed.

bash
npx rebrowser-patches@latest patch --packageName puppeteer-core

To revert:

bash
npx rebrowser-patches@latest unpatch --packageName puppeteer-core

To patch by absolute path (useful in Docker or monorepos):

bash
npx rebrowser-patches@latest patch --packagePath /web/app/node_modules/puppeteer-core-custom

Windows note: The patch command requires Git in PATH. Install from https://git-scm.com/download/win, then:

bash
set PATH=%PATH%;C:\Program Files\Git\usr\bin\
patch -v

Option B: Drop-in replacement packages (Node.js)

Replace puppeteer / puppeteer-core / playwright / playwright-core in your package.json with the pre-patched equivalents using npm aliases:

json
{
  "puppeteer": "npm:rebrowser-puppeteer@^23.3.1",
  "puppeteer-core": "npm:rebrowser-puppeteer-core@^23.3.1"
}

Then install normally:

bash
npm install

Available pre-patched packages:

PackageRegistry
rebrowser-puppeteernpm
rebrowser-puppeteer-corenpm
rebrowser-playwrightnpm
rebrowser-playwright-corenpm
rebrowser-playwrightPyPI (Python)

Option C: Python Playwright (PyPI)

bash
pip install rebrowser-playwright

Cloud Platform Setup (no local install required)

  1. Create an account at https://rebrowser.net/my/signup.
  2. Go to Dashboard / Profiles and create a browser profile.
  3. Copy your API key from Dashboard / API.
  4. (Optional) Add proxies via the Proxies dashboard.
  5. In your Puppeteer or Playwright code, replace the local browser launch with the Rebrowser remote CDP endpoint URL.

No local browser binary is needed when using the cloud platform.