Lightpanda is an installer and runner for the Lightpanda headless browser.

This package fetches binaries from the u2i fork build of Lightpanda, which carries an extra patch sending session cookies on the WebSocket upgrade request — required for cookie-authenticated WS endpoints (e.g. Phoenix LiveView). The release tag, download URL, and checksums are baked in; there are no knobs for swapping the source. If you need an unpatched upstream binary, depend on a different installer.

Configuration

Configure in your config/config.exs:

config :lightpanda,
  default: [
    args: ~w(serve --host 127.0.0.1 --port 9222)
  ]

Global options

• :path - point at a locally-built binary on disk instead of the one this package downloads. Takes a full file path, not a directory. Intended for developers working on the lightpanda fork itself who want to test rebuilds without republishing the package. Production users should leave this unset.

• :install_dir - directory where the binary is installed and looked for. The package always picks the filename (lightpanda-<target>), so consumers set only the directory. Relative paths are resolved against the current working directory (File.cwd!/0) — e.g. ".browsers" resolves to <project_root>/.browsers/lightpanda-<target>, matching the convention used by Chrome for Testing and Puppeteer. May also be set via the LIGHTPANDA_INSTALL_DIR environment variable; the config key takes precedence when both are present.

Precedence: :path (full file) overrides :install_dir (directory), which overrides the default location under _build/.

Profiles

Each profile accepts:

• :args - arguments to pass to the lightpanda binary.
• :cd - the working directory.
• :env - environment variables as a map of string key/value pairs.