Skip to Content
Getting StartedInstallation

Installation

Install from Docker

Lightpanda provides official Docker images for both Linux amd64 and arm64 architectures.

The following command fetches the Docker image and starts a new container exposing Lightpanda’s CDP server on port 9222.

The --privileged option is required because the browser requires io_uring syscalls which are blocked by default by Docker.

$ docker run -d --name lightpanda -p 9222:9222 --privileged lightpanda/browser:nightly

Install from the nightly builds

The latest binary can be downloaded from the nightly builds for Linux x86_64 and MacOS aarch64.

For Linux

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

For MacOS

curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos && \ chmod a+x ./lightpanda

For Windows + WSL2

The Lightpanda browser is compatible to run on Windows inside WSL (Windows Subsystem for Linux). If WSL has not been installed before follow these steps (for more information see: MS Windows install WSL). Install & open WSL + Ubuntu from an administrator shell:

  1. wsl --install
  2. — restart —
  3. wsl --install -d Ubuntu
  4. wsl

Once WSL and a Linux distribution have been installed the browser can be installed in the same way it is installed for Linux. Inside WSL install the Lightpanda browser:

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

It is recommended to install clients like Puppeteer on the Windows host.

Telemetry

By default, Lightpanda collects and sends usage telemetry. This can be disabled by setting an environment variable LIGHTPANDA_DISABLE_TELEMETRY=true. You can read Lightpanda’s privacy policy at: https://lightpanda.io/privacy-policy.