Octo Browser SOP

Appearance

Install ​

Octo Browser is a desktop application. There is no npm package or CLI installer. The browser must be downloaded and installed from the official site before the Local Client API or automation libraries can be used.

Step 1: Download the desktop app ​

Go to the official download page and download the installer for your OS:

https://octobrowser.org/download/

Supported platforms:

  • Windows (installer .exe)
  • macOS (DMG)
  • Linux (AppImage or .deb)

Step 2: Install and sign in ​

Run the installer, launch Octo Browser, and sign in with your Octo account. The Local Client API server starts automatically on http://127.0.0.1:58888 when the desktop app is running and a user is signed in.

Step 3: Install automation dependencies (for scripted workflows) ​

For Puppeteer (Node.js):

bash
npm install puppeteer axios

For Playwright (Node.js):

bash
npm install playwright axios

For Playwright (Python):

bash
pip install playwright httpx
playwright install chromium

For Pyppeteer (Python):

bash
pip install pyppeteer httpx

API access ​

The Local Client API (http://127.0.0.1:58888) requires no authentication token. It is available only while the desktop app is running.

The Cloud Automation API (https://app.octobrowser.net/api/v2/automation) requires an X-Octo-Api-Token header. Generate your token in the Octo Browser dashboard under Settings > API. API access requires Base plan (EUR 79/mo) or higher.

Mirror base URLs if the primary is unreachable:

  • https://app.octobrowser-mirror1.com/api/v2/automation
  • https://app.octobrowser-mirror1.net/api/v2/automation
  • https://app.octobrowser-mirror1.org/api/v2/automation