Create a browser
session_id, cdp_ws_url, webdriver_ws_url, and browser_live_view_url. See create a browser for the full walkthrough, including creating from a browser pool.
Pick a browser type
Set common options
- Viewport: defaults to 1920x1080 at 25Hz. A custom viewport restarts Chromium on creation, so use a browser pool if you need it to be instant.
- Termination and timeouts:
timeout_secondssets how long a browser can sit in standby before KERNEL deletes it. It defaults to 60 seconds and can be up to 72 hours. Delete browsers explicitly when you’re done; Playwright’sbrowser.close()doesn’t delete them.
More browser settings
Often agents don’t require these, but they’re there when you do:- Regions: run browsers in
us-east,eu-west, orap-southeast, closer to your code and your users. - Extensions: load unpacked Chrome extensions into a browser.
- Chrome policies: apply Chrome enterprise policies, such as startup pages and bookmarks.
- Private networking: reach services behind a VPN or tunnel from inside the browser session.
What to configure next
Stealth
Anti-detection defaults, stealth mode, CAPTCHA handling, and Web Bot Auth.
Proxies
Route traffic through datacenter, ISP, residential, or mobile IPs, or bring your own.
Profiles
Save cookies, storage, and logins from one session and load them into the next.
Vaults
Store credentials and payment items that a browser fills into a page without your agent reading them.
Authentication
Fill logins from a vault, or let managed auth handle the login and attempt to reauthenticate eligible connections.
Payments
Let agents complete checkouts through a wallet without handling raw card details.
Config Registry
Get browser and proxy settings that have already worked on the site you’re automating.