Installation

One-liner installer

For Linux or MacOSx users, you can install Lightpanda with following command. For Windows, take a look at the dedicated section.


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

ℹ️

curl, jq and sha256sum are required to install Lightpanda with the one-liner installer.

By default the installer installs the last nightly build. But you can pick a specific release:


curl -fsSL https://pkg.lightpanda.io/install.sh | bash -s "v0.2.5"

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.


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

Install manually from the nightly builds

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

Linux x86_64


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

Linux aarch64


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

MacOS aarch64


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

MacOS x86_64


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

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:

wsl --install
— restart —
wsl --install -d Ubuntu
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 .