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:
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 .