BotBrowser Documentation

Install BotBrowser, launch it through your framework, validate the browser model, and move into production from one docs center.

New here? Follow this path: Installation -> Playwright or Puppeteer -> First Verification -> deployment and identity guides when you are ready.

Quick Start

Use Installation to set up binaries, host dependencies, and profile storage.

Choose Playwright or Puppeteer. If you need raw CDP control, use Bot Script.

Run First Verification for a fast smoke test, then review the broader Validation matrix.

Set up binaries, run your first local session, and move into Playwright or Puppeteer.

Keep proxy IP, locale, timezone, DNS, and WebRTC signals coherent.

Understand what BotBrowser protects across canvas, WebGL, fonts, timing, and workers.

Separate identities with per-context fingerprints, cookies, storage, and browser branding.

Run Windows, Android, WebView, or cross-platform identities from one host environment.

Move from local testing to Ubuntu, Docker, screenshots, and distributed workloads.

Use the canonical reference when you need launch flags, profile keys, and subsystem details.

Read the validation matrix, benchmark evidence, and policy pages that define how BotBrowser should be evaluated and deployed.

Area	Use It For	Start Here
Getting Started	Install BotBrowser, launch it from automation frameworks, manage profiles, and verify fingerprint behavior before scaling out.	Installation
Network & Proxy	Configure proxy routing, DNS and WebRTC leak prevention, GeoIP alignment, and per-context network isolation.	Proxy Configuration
Fingerprint Protection	Review surface-by-surface protection for canvas, WebGL, fonts, media, timing, navigator properties, and worker consistency.	Browser Fingerprinting Overview
Identity & Session	Control browser branding, locale and timezone, cookies and storage, and account isolation across contexts and sessions.	Per-Context Fingerprint
Platform Emulation	Run Windows, macOS, Linux, Android, and WebView identities with aligned device metrics, fonts, and DRM capabilities.	Cross-Platform Profiles
Deployment & Operations	Prepare headless servers, Docker environments, screenshot pipelines, and distributed workloads for production use.	Headless Server Setup
Reference	Use the canonical CLI, advanced feature, and profile configuration references when you need exact flag and subsystem details.	CLI Flags
Proof & Validation	Inspect validation coverage and measured benchmark data across anti-bot systems, tracking surfaces, and deployment scenarios.	Validation
Policies & Responsible Use	Review authorization requirements, legal boundaries, and responsible-use expectations before deploying BotBrowser.	Responsible Use

Canonical content lives in the BotBrowser GitHub repository .
This docs center syncs docs/guides plus selected root docs on every build so the website stays aligned with product documentation.
For legal and operational boundaries, review Responsible Use and Legal Disclaimer.