Puppeteer could not find Chrome: installation and cache diagnosis

The expected Chrome build is absent from the configured Puppeteer cache.

Error message

Could not find Chrome (ver. {value}). This can occur if either

{value} is replaced by the value shown in your error message.

How this error happens

The configured cache has no compatible chrome executable. Installation may have skipped the browser download, or the runtime may use a different cache from the installer.

The failing launch assumes the expected browser is absent from the configured cache.

import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
    browser: "chrome",
});

How to fix

Download the package-managed browser in the same project and cache environment used by your application.

npx puppeteer browsers install chrome

Things to keep in mind

After installation, rerun the launch. In CI or a container, make the browser cache available to the runtime user; installing it in a different user’s private cache does not help.

All Puppeteer errors