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, verify the binary and profile path, then start the first session before connecting automation.
  2. Playwright - Launch BotBrowser with Playwright: profile-first startup, proxy-aware browser contexts, cleanup rules, and repeatable automation configuration.
  3. Puppeteer - Launch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
  4. First Verification - Verify a new BotBrowser install: fingerprint checks, profile loading, proxy alignment, and cross-platform consistency before automating.

All Guides

GuideDescription
InstallationInstall BotBrowser on Windows, macOS, and Linux, verify the binary and profile path, then start the first session before connecting automation.
PlaywrightLaunch BotBrowser with Playwright: profile-first startup, proxy-aware browser contexts, cleanup rules, and repeatable automation configuration.
PuppeteerLaunch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
Bot ScriptBot Script and BotScript automation in BotBrowser: —bot-script syntax, botscripts, Chrome Debugger API events, and a worked example.
CLI RecipesBotBrowser CLI recipes for profile loading, proxy routing, identity configuration, headless startup, and repeatable server deployment.
Google Translate Page TranslationUse your own Google Cloud API key to enable page translation in BotBrowser.
Profile ManagementManage BotBrowser profile files, versions, and storage paths so browser identity stays reproducible across sessions, hosts, and deployments.
First VerificationVerify a new BotBrowser install: fingerprint checks, profile loading, proxy alignment, and cross-platform consistency before automating.
Updated