docs(browser): add Lightpanda sidecar overlay + backends doc

- docker-compose.lightpanda.yml: opt-in overlay running
  lightpanda/browser:latest, wires GOCLAW_BROWSER_REMOTE_URL and
  GOCLAW_BROWSER_BACKEND so the manager picks the right code path.
- docs/browser-backends.md: compatibility matrix vs Chrome (screenshot,
  multi-tab, cookie sharing, etc.) and guidance on when to pick which.
This commit is contained in:
Pierre Tachoire committed 2026-07-01 10:23:17 +02:00
1 parent 2e35a3faac
commit 890ced810d
2 files changed
+95

No files matched your search

+38
View File
@@ -0,0 +1,38 @@
# Lightpanda sidecar overlay — lightweight CDP browser.
#
# Usage:
# docker compose -f docker-compose.yml -f docker-compose.postgres.yml -f docker-compose.lightpanda.yml up -d --build
#
# Lightpanda (https://lightpanda.io) is a low-memory headless browser with CDP
# support. Opt-in alternative to the Chrome sidecar (docker-compose.browser.yml).
# See docs/browser-backends.md for the compatibility matrix.
services:
lightpanda:
# Official Lightpanda CDP image: https://hub.docker.com/r/lightpanda/browser
image: lightpanda/browser:latest
ports:
- "127.0.0.1:${LIGHTPANDA_CDP_PORT:-9222}:9222"
healthcheck:
# Minimal TCP probe via sh's /dev/tcp. If the image is scratch-based
# without a shell, drop healthcheck and change depends_on below to
# `condition: service_started`.
test: ["CMD-SHELL", "exec 3<>/dev/tcp/127.0.0.1/9222 || exit 1"]
interval: 5s
timeout: 3s
retries: 5
deploy:
resources:
limits:
# Lightpanda is ~10x lighter than Chrome.
memory: 512M
cpus: '1.0'
restart: unless-stopped
goclaw:
environment:
- GOCLAW_BROWSER_REMOTE_URL=ws://lightpanda:9222
- GOCLAW_BROWSER_BACKEND=lightpanda
depends_on:
lightpanda:
condition: service_healthy