Getting Started with BrowserMesh Automation Platform

The Definitive Quickstart & Deployment Guide to Installing Desktop Apps, Android Cellular Nodes, and Headless Linux Daemons for Distributed Browser Automation.

Welcome to the official BrowserMesh Platform Documentation. BrowserMesh is a self-hosted browser automation and distributed RPA platform engineered from the ground up for software developers, QA test engineers, and enterprise automation teams.

Unlike legacy cloud automation setups that execute inside expensive cloud servers with high per-minute costs and bandwidth surcharges, BrowserMesh moves browser execution directly to your local hardware—your everyday laptop, desktop workstation, Android smartphone, or private Linux server. By utilizing your own infrastructure, you achieve 100% local data sovereignty and zero cloud execution markup.

Meanwhile, our cloud orchestrator manages identity, validates licensing quotas, coordinates your multi-device fleet, and powers an integrated marketplace of 250+ pre-built automation workflows. All browser execution runs through AutomationEngine—a high-resilience headless Chromium engine that stores all data locally in your private SQLite database.

How to Access the Universal Web Studio Console?

All platform orchestration, workflow configuration, live canvas streaming, and fleet telemetry are managed through the central Web Studio console at studio.browsermesh.in. Create a free account to monitor connected devices, configure automation tasks, and export structured data securely.

• Official Web Studio Console: https://studio.browsermesh.in
• Account Capabilities: Create an account or log in to monitor your connected hardware fleet, configure marketplace workflows, observe live runs at 30+ FPS, and download execution datasets.

Why Does the Studio Console Require Local Network Access?

BrowserMesh uses a decentralized architecture where the cloud management studio runs in your browser, while the automation daemon executes locally on your hardware at 127.0.0.1:3001. Chromium Private Network Access prompts require clicking Allow so the dashboard can communicate with your local execution engine.

┌───────────────────────────────────────────────────────────────────────────────┐
│  studio.browsermesh.in wants to:                                             │
│  Access other apps and services on this device                                │
│                                                                               │
│                                [ Block ]  [ Allow ]                           │
└───────────────────────────────────────────────────────────────────────────────┘

What Happens If You Click Block on the Permission Prompt?

If you accidentally click Block on the browser permission dialog, your browser will prevent the Studio dashboard from communicating with your local companion daemon. This blocks workflow execution dispatches, heartbeats, and canvas video streams until you reset permission settings.

• How to fix if accidentally blocked:
  1. Click the "Tune" / Sliders icon or Lock icon on the far-left of your browser's address bar (next to studio.browsermesh.in).
  2. Locate the permission labeled "Access other apps and services on this device" (or "Local network access").
  3. Toggle the dropdown from Block to Allow.
  4. Refresh your browser tab (Ctrl + R or F5).
• The Desktop App Alternative (Zero Prompts): If you prefer not to manage browser permission dialogs, downloading the standalone BrowserMesh Desktop App (Windows / Linux) communicates with the local engine natively over operating system channels!

3. Platform Installation Methods (4-in-1 Architecture)

BrowserMesh adapts to any operational workflow, offering both Desktop & Mobile Graphical Applications (GUI) and Headless Server Daemons (CLI).

                               ┌─────────────────────────────┐
                               │   BrowserMesh Web Studio    │
                               │ (studio.browsermesh.in)     │
                               └──────────────┬──────────────┘
                                              │
                     ┌────────────────────────┴────────────────────────┐
                     ▼                                                 ▼
     ┌───────────────────────────────┐                 ┌───────────────────────────────┐
     │      Graphical GUI Apps       │                 │     Headless Node Daemons     │
     ├───────────────────────────────┤                 ├───────────────────────────────┤
     │ • Windows Desktop (.exe)      │                 │ • Linux / Ubuntu (curl script)│
     │ • Linux Desktop (.AppImage)   │                 │ • Windows Server (PowerShell) │
     │ • Android Mobile APK (4G/5G)  │                 │ • Windows CMD / Double-Click  │
     └───────────────────────────────┘                 └───────────────────────────────┘

Option A: Desktop & Mobile Graphical Applications (GUI)

If you prefer graphical user interfaces with visual controls and native desktop features:

1. Windows Desktop Application

• Package: Standalone Windows Installer (BrowserMesh-Setup-1.0.0.exe).
• Capabilities: Bundles both the Studio interface and the Local Edge Automation Engine in a single package. Communicates over internal system channels with zero browser permission dialogs.
• Download: Download directly from the Download Portal or run the setup wizard.
• Windows Defender Firewall Note: The first time AutomationEngine or the backend daemon runs on Windows, Windows Defender Firewall will ask to permit communication. Check the box for "Private networks (such as home or work)" and click "Allow access".

2. Linux Desktop Application

• Package: Native .deb package (Debian / Ubuntu) or standalone .AppImage (Fedora, Arch, CentOS).
• AppImage Quickstart:
  Terminal / Code

  Copy

  chmod +x BrowserMesh-linux.AppImage
  ./BrowserMesh-linux.AppImage
  

3. Android Mobile Application (Mobile Browser Automation)

• Package: BrowserMesh-v1.0.apk (Requires Android 10 or newer).
• Mobile Node Capabilities: Embeds a complete, ultra-lightweight Linux container and ARM64 Node.js engine directly inside your phone, turning your mobile device into a dedicated automation node.
• Permissions Required: Grant "Ignore battery optimization" and allow "Notifications" so Android does not terminate long-running workflows when your phone locks. Uses an automatic Screen WakeLock during active jobs.

Option B: Headless Terminal Node Scripts (CLI & Server Deployment)

For continuous 24/7 background execution on Linux cloud VPS instances (Ubuntu, Debian, DigitalOcean, Hetzner, AWS EC2), dedicated servers, or headless mini-PCs:

1. Linux & macOS Automated Installer (Bash / Terminal)

Open your terminal and run this 1-line command:

curl -sSL https://www.browsermesh.in/scripts/install-headless.sh | bash

Alternative using wget:

wget -qO- https://www.browsermesh.in/scripts/install-headless.sh | bash

• What the script does:
  • Checks system dependencies (Node.js, Chromium libraries, PM2).
  • Installs the BrowserMesh daemon in ~/.browsermesh/.
  • Configures PM2 process supervisor for automatic crash recovery and auto-reboot on system restarts.
  • Connects securely to your BrowserMesh cloud account so you can trigger and monitor workflows remotely from https://studio.browsermesh.in.

2. Windows Headless Setup (PowerShell / CMD / Double-Click)

• Option 1: One-Line PowerShell Command (Recommended for Windows Server)

  Terminal / Code

  Copy

  powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://www.browsermesh.in/scripts/install-headless.ps1 | iex"
  

• Option 2: One-Line CMD Command

  Terminal / Code

  Copy

  curl -sL https://www.browsermesh.in/scripts/install-headless.cmd -o install.cmd && install.cmd
  

• Option 3: Double-Click Installer File

  1. Download install-headless.cmd directly to your computer.
  2. Double-click install-headless.cmd in Windows File Explorer to launch the automated command-line setup window.

4. AutomationEngine Architecture

Under the hood, BrowserMesh is powered by AutomationEngine, our browser execution engine designed for high web application compatibility:

• Clean Automation Environment: Standardizes Chromium runtime parameters and execution contexts for consistent rendering.
• Playwright Core Architecture: Delivers a complete Playwright automation environment with native bindings.
• Bio-Realistic Kinematics: Simulates natural Bezier curve mouse movements, typing cadence variations, and inertial scrolling dynamics.
• Local Data Sovereignty: All extracted datasets and workflow logs are stored locally in your private SQLite database.

5. Managing Your Node & Fleet Orchestration

Once installed (via GUI app or Headless CLI script), your node communicates with the BrowserMesh cloud orchestrator:

Automated Cloud Registration

1. The installer automatically starts the local companion daemon on http://127.0.0.1:3001.
2. Open https://studio.browsermesh.in and log into your account.
3. Your machine will immediately appear under the Active Devices tab (/settings?tab=sessions) showing host OS, CPU health score, and network connection status.

Smart Port Auto-Discovery (Port Conflict Resolution)

If default port 3001 is already in use by another software on your machine, the BrowserMesh local daemon automatically increments to port 3002, 3003, etc. The Studio frontend includes a smart port auto-scanner that automatically binds to the active daemon without manual configuration.

Headless CLI Management Commands

For servers running the headless CLI node, manage your daemon with simple terminal commands:

# Check CPU, memory consumption, and daemon connectivity
mesh status

# Stream live real-time workflow logs and engine events
mesh logs

# Reboot the background automation daemon
mesh restart

# Pause the node daemon
mesh stop

# Resume background node execution
mesh start

6. Step-by-Step Quickstart: Running Your First Workflow

Getting from installation to your first completed workflow takes under 60 seconds:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│ 1. Open Studio  │ ──► │ 2. Pick Template│ ──► │ 3. Configure    │ ──► │ 4. Watch & Save │
│ (studio.        │     │ (Marketplace    │     │ (Form, JSON, or │     │ (Live Screencast│
│ browsermesh.in) │     │ 250+ Workflows) │     │ Copy AI Prompt) │     │ Excel/CSV Export│
└─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘

1. Step 1: Open Studio & Complete First-Launch Check
   • Visit https://studio.browsermesh.in. Click Allow on the local network prompt.
   • The onboarding wizard will verify connection to http://127.0.0.1:3001 and confirm AutomationEngine readiness.
2. Step 2: Pick a Workflow Template from Marketplace
   • Navigate to Marketplace (/marketplace).
   • Select a pre-built template—such as Amazon E-Commerce Price & Catalog Monitor, Google Maps Business Directory Analyzer, or QA testing templates.
   • Click Install. The package is verified and added to your library immediately.
3. Step 3: Configure Your Workflow Parameters
   • Click Run Job on your installed template.
   • Choose your preferred configuration mode:
     • Visual Form Mode: Enter parameters and adjust options in a clean GUI.
     • JSON Code Mode: Paste or edit raw JSON payloads with live syntax highlighting.
     • The "Copy AI Prompt" Engine: Click Copy AI Prompt, paste it into ChatGPT, Claude, or Gemini with plain-English instructions, and paste the resulting JSON configuration back into Studio.
4. Step 4: Launch & Supervise via 30+ FPS Live Monitor
   • Click Launch Job.
   • Watch the workflow live at 30+ frames per second via the Live Monitor (/live-monitor).
   • If an interactive step requires human confirmation, the Interactive Human-in-the-Loop Workspace lets you interact directly on your screen. The job resumes immediately.
5. Step 5: Explore & Export Your Dataset
   • When the workflow finishes, open the Results Explorer (/jobs/:jobId/results).
   • Inspect items across 4 dynamic views: Table View (interactive grid), Smart View (nested data), Cards View (media-heavy records), and JSON View (raw tree).
   • Click Export to download your data locally in Microsoft Excel (.xlsx), CSV (.csv), JSON (.json), or Formatted HTML Tables (.html).

7. Building Custom Workflows with the Developer SDK

BrowserMesh features a modular plugin architecture that lets developers build and deploy custom automation workflows with minimal friction:

The run(context) Plugin Model

BrowserMesh provides built-in primitives for storage, logs, and exports:

• Write standard automation routines using Playwright Core and AutomationEngine.
• Emit structured records with one function call:
  Terminal / Code

  Copy

  import { AutomationContext } from '@browsermesh/sdk';
  
  export async function run(context: AutomationContext) {
    const page = await context.newPage();
    await page.goto(context.inputs.targetUrl);
  
    const items = await page.$$eval('.product-card', cards => 
      cards.map(el => ({
        title: el.querySelector('h2')?.textContent?.trim(),
        price: parseFloat(el.querySelector('.price')?.textContent?.replace('$', '') || '0')
      }))
    );
  
    for (const item of items) {
      await context.emit('result', item);
    }
  }
  

• BrowserMesh automatically handles SHA-256 entity deduplication, local SQLite storage, live counter updates, and multi-view grid rendering!

Workflow Manifest Schema (manifest.json)

Declare your input parameters and output fields in manifest.json:

{
  "id": "custom-ecommerce-monitor",
  "name": "Custom E-Commerce Price Monitor",
  "version": "1.0.0",
  "author": "Your Team",
  "category": "E-Commerce",
  "inputs": [
    { "name": "targetUrl", "type": "string", "label": "Catalog URL", "required": true },
    { "name": "maxPages", "type": "number", "label": "Max Pages", "default": 5 }
  ],
  "outputs": ["title", "price", "productUrl"]
}

• Local Private Deployment: Drop your plugin folder directly into scraper_data/plugins/ on your machine to use it immediately inside your organization.
• Public Marketplace Publishing: Submit your package to the BrowserMesh Marketplace for community distribution.

8. Troubleshooting & Operational Diagnostics

9. Subscription Plans & Licensing Quotas

BrowserMesh provides transparent pricing with instant digital delivery:

Next Steps & Additional Resources

• Download Client Apps: Official Download Center (/download)
• Explore 250+ Workflows: Browse Plugin Marketplace (/marketplace)
• Compare Pricing & Quotas: Transparent Pricing Plans (/pricing)
• Deep Dive into Architecture: How BrowserMesh Works (/docs/how-it-works)
• Engine Features: AutomationEngine Capabilities (/features)
• Windows Node Setup: Windows Installation Guide (/docs/install-windows)
• Android Node Setup: Android Installation Guide (/docs/install-android)
• Linux Server Setup: Linux Installation Guide (/docs/install-linux)
• Launch Web Studio: Open Mission Control (https://studio.browsermesh.in)