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, profile path, launcher flow, and first browser session before connecting automation frameworks.
  2. Playwright - Launch BotBrowser with Playwright using profile-first startup, proxy-aware browser contexts, cleanup rules, and configuration patterns for repeatable automation sessions.
  3. Puppeteer - Launch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
  4. First Verification - Verify a new BotBrowser setup with browser fingerprint checks, profile loading, proxy alignment, and basic cross-platform consistency before moving into automation workflows.

All Guides

GuideDescription
InstallationInstall BotBrowser on Windows, macOS, and Linux, then verify the binary, profile path, launcher flow, and first browser session before connecting automation frameworks.
PlaywrightLaunch BotBrowser with Playwright using profile-first startup, proxy-aware browser contexts, cleanup rules, and configuration patterns for repeatable automation sessions.
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 BotBrowser CLI recipes for profile loading, proxy routing, identity configuration, headless startup, and repeatable deployment patterns across local and server environments.
Profile ManagementManage BotBrowser profile files, profile versions, storage paths, and lifecycle rules so browser identity remains reproducible across sessions, hosts, and deployment stages.
First VerificationVerify a new BotBrowser setup with browser fingerprint checks, profile loading, proxy alignment, and basic cross-platform consistency before moving into automation workflows.
Updated