Skip to content

CROSS_PLATFORM_PROFILES.md

Latest commit

 

History

History
108 lines (65 loc) · 3.21 KB

CROSS_PLATFORM_PROFILES.md

File metadata and controls

108 lines (65 loc) · 3.21 KB

Cross-Platform Profiles

Use one BotBrowser profile across different host operating systems while keeping profile identity stable.

Prerequisites

  • BotBrowser installed on target hosts. See Installation.
  • Profile file (.enc or .json).
  • ENT Tier1 for Linux/Ubuntu hosts.

Quick Start

Run the same profile on different hosts. Only the executable path changes:

# macOS
/Applications/Chromium.app/Contents/MacOS/Chromium --bot-profile="/path/to/profile.enc" --headless

# Linux
chromium-browser --bot-profile="/path/to/profile.enc" --headless

# Windows
chrome.exe --bot-profile="C:\profiles\profile.enc" --headless

How It Works

Cross-platform profiles are profile-driven, not host-driven:

  1. Identity surfaces come from profile data (UA, screen, fonts, GPU, language stack).
  2. BotBrowser applies profile values at engine level before page scripts run.
  3. Host OS differences are constrained so the profile remains the primary identity source.

Use this guide as the portability overview. For Windows-profile specifics, see Windows on macOS/Linux.

Support Matrix

Profile Target Windows Host macOS Host Linux Host (ENT Tier1)
Windows profile Supported Supported Supported
macOS profile Supported Supported Supported
Android profile Supported Supported Supported

Common Scenarios

Develop on macOS, deploy on Linux

Keep one profile artifact in source control or secret storage and deploy unchanged.

Multi-OS validation in CI

Run the same profile on Windows/macOS/Linux runners and compare key outputs (navigator.platform, languages, screen values, rendering hashes).

Fleet migration

Move workloads between cloud hosts without regenerating identity profiles.

Troubleshooting / FAQ

Problem Solution
Different output across hosts Verify same BotBrowser version, same profile file, same launch flags.
Linux host unsupported Linux requires ENT Tier1.
CJK rendering differs See CJK Font Rendering.
GPU-related differences in headless Review Headless Server Setup and GPU mode consistency.

Next Steps

Related documentation: Advanced Features | Profiles README

Legal Disclaimer & Terms of Use • Responsible Use Guidelines. BotBrowser is for authorized fingerprint protection and privacy research only.