Lightpanda SOP

Appearance

Install ​

Lightpanda ships in multiple forms. Pick the one that matches your environment.

This installs the binary automatically via the npm postinstall script. Works on Linux and macOS.

bash
mkdir my-project && cd my-project
npm init -y
npm install --save @lightpanda/browser

Then install a CDP client (choose one):

bash
# Puppeteer (most common)
npm install --save puppeteer-core

# Or Playwright
npm install --save playwright-core

Option 2: curl installer script ​

bash
curl -fsSL https://pkg.lightpanda.io/install.sh | bash

Installs the latest stable binary to your PATH. Linux and macOS only.

Option 3: Homebrew (macOS) ​

bash
brew install lightpanda-io/browser/lightpanda

Option 4: Prebuilt binary (Linux x86_64) ​

bash
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux
chmod a+x ./lightpanda

For macOS aarch64, replace x86_64-linux with aarch64-macos.

Option 5: Docker ​

bash
docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:nightly

Exposes the CDP server on port 9222. No local binary needed.

Platform Notes ​

  • Linux (x86_64, aarch64) and macOS are supported.
  • Windows is not supported by the native binary. Use Docker on Windows.
  • Requires Node.js 18+ when using the npm package.