Puppeteer: Could not find Firefox (rev. {value}). This can occur if either

The expected Firefox build is absent from the configured cache.

Error message

Could not find Firefox (rev. {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 firefox 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: "firefox",
});

How to fix

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

npx puppeteer browsers install firefox

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