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:

Identity surfaces come from profile data (UA, screen, fonts, GPU, language stack).
BotBrowser applies profile values at engine level before page scripts run.
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

Windows on macOS/Linux. Windows-profile focused workflow.
Android Emulation. Android identity on desktop hosts.
CJK Font Rendering. East Asian typography consistency.
Profile Management. Profile lifecycle and versioning.

Related documentation: Advanced Features | Profiles README

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