WINDOWS_ON_MAC_LINUX.md

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.