Skip to main content
Guides

Chrome Dependency

The local Lighthouse auditor requires an installed Chrome browser. Chrome Launcher discovers the browser used by each audit worker.

Select an installed browser

CHROME_PATH=/usr/bin/google-chrome pnpm exec unlighthouse --site https://example.com

Set CHROME_PATH to the executable available on your machine or container. Use CHROME_FLAGS for process arguments. See Chrome Options.

Previous download settings

Legacy chrome.useSystem and download-fallback options do not configure the v1 local auditor. Install the browser before running scans. puppeteerOptions.executablePath has no effect on the v1 local auditor.

Did this page help you?
Anything that could be done better? :)
Help us improve this page. You can edit this page on GitHub or provide anonymous feedback below.