Running Windows Profiles on macOS and Linux

Deploy Windows-target browser identity on non-Windows hosts with profile-consistent behavior.

Prerequisites

BotBrowser on macOS or Linux.
Windows profile file (.enc or .json).
ENT Tier1 for Linux/Ubuntu hosts.

Quick Start


# macOS
/Applications/Chromium.app/Contents/MacOS/Chromium \
  --bot-profile="/path/to/windows-profile.enc" \
  --headless
 
# Linux
chromium-browser \
  --bot-profile="/path/to/windows-profile.enc" \
  --headless

Optional geo alignment:


--proxy-server=socks5://user:pass@proxy.example.com:1080

How It Works

This guide is the Windows-profile specialization of Cross-Platform Profiles.

For a Windows-target profile, BotBrowser keeps Windows-facing signals aligned (platform metadata, Windows-oriented font behavior, screen/device surfaces, and related headers) even when host OS is macOS or Linux.

Common Scenarios

macOS development, Linux production

Use one Windows profile in both environments to keep deployment identity stable.

Regional Windows identity


--bot-profile="/path/to/windows-profile.enc" \
--proxy-server=socks5://user:pass@de-proxy.example.com:1080 \
--bot-config-timezone=Europe/Berlin \
--bot-config-locale=de-DE \
--bot-config-languages=de-DE,de,en-US,en

Multiple Windows identities per browser (ENT Tier3)


// Puppeteer
const client = await browser.target().createCDPSession();
const context = await browser.createBrowserContext();
 
await client.send("BotBrowser.setBrowserContextFlags", {
  browserContextId: context._contextId,
  botbrowserFlags: [
    "--bot-profile=/path/to/windows-profile.enc",
    "--proxy-server=socks5://user:pass@proxy.example.com:1080",
  ],
});

Troubleshooting / FAQ

Problem	Solution
`navigator.platform` does not match expected Windows value	Confirm BotBrowser binary and correct `--bot-profile` are used.
Rendering/hash mismatch between hosts	Ensure BotBrowser version and profile file are identical across hosts.
Linux instance not available	ENT Tier1 is required on Linux/Ubuntu.
CJK text differences	See CJK Font Rendering.

Next Steps

Cross-Platform Profiles. General portability model.
CJK Font Rendering. Font and glyph consistency details.
Device Emulation. Device/screen tuning.
Headless Server Setup. Linux deployment baseline.

Related documentation: Profiles README | Advanced Features

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