Install

Oxylabs Headless Browser is a remote service, not a local binary. There is nothing to download or install beyond the client library you already use for browser automation.

Prerequisites

• An active Oxylabs account with Headless Browser enabled
• Your Oxylabs username and password (from the dashboard at https://dashboard.oxylabs.io)

Python (Playwright)

Install the Playwright Python library:

pip install playwright

Install the Playwright browser binaries (only needed for local fallback; the remote connection does not use local binaries):

playwright install chromium

Node.js (Puppeteer)

npm install puppeteer

Or with pnpm:

pnpm add puppeteer

Node.js (Playwright)

npm install playwright

Or with pnpm:

pnpm add playwright

Connection endpoints

Once your client library is installed, connect to the Oxylabs cloud browser using a WebSocket URL. No additional SDK is required.

Browser	Region	Endpoint
Chromium	Global	wss://ubc.oxylabs.io
Chromium	US	wss://ubc-us.oxylabs.io
Firefox	Global	wss://ubs.oxylabs.io
Firefox	US	wss://ubs-us.oxylabs.io

Credentials are embedded in the WebSocket URL: wss://USERNAME:PASSWORD@ubc.oxylabs.io