Skip to Content
Getting Started

Getting Started

Install BotBrowser, launch it from automation frameworks, manage profiles, and verify fingerprint behavior before scaling out.

New to this section? Start with Installation.

Use This Section When You Need To

  • You are setting up BotBrowser for the first time.
  • You need a minimal Playwright or Puppeteer launch that stays profile-consistent.
  • You want the shortest path from install to first verification.
  1. Installation - Install BotBrowser on Windows, macOS, and Linux, then verify the binary and profile setup.
  2. Playwright - Launch BotBrowser with Playwright using profile-first configuration and framework-specific cleanup.
  3. Puppeteer - Launch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
  4. First Verification - Verify BotBrowser fingerprint protection with CreepJS and BrowserLeaks after setup.

All Guides

GuideDescription
InstallationInstall BotBrowser on Windows, macOS, and Linux, then verify the binary and profile setup.
PlaywrightLaunch BotBrowser with Playwright using profile-first configuration and framework-specific cleanup.
PuppeteerLaunch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
Bot ScriptAutomate BotBrowser without Playwright or Puppeteer using --bot-script and the Chrome Debugger API.
CLI RecipesUse copy-paste BotBrowser CLI recipes for proxy, fingerprint, identity, and deployment scenarios.
Profile ManagementManage BotBrowser profile files, versions, and lifecycle for reproducible fingerprint protection.
First VerificationVerify BotBrowser fingerprint protection with CreepJS and BrowserLeaks after setup.