(Created on )

Puppeteer: ERROR: Failed to set up {value} v{value}! Set 'PUPPETEER_SKIP_DOWNLOAD' env variable to...

Puppeteer's installation step failed to set up the requested browser build.


Puppeteer’s installation step failed to set up the requested browser build.

Error message

ERROR: Failed to set up {value} v{value}! Set 'PUPPETEER_SKIP_DOWNLOAD' env variable to...

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

How this error happens

Puppeteer’s npm installation also sets up a browser. If the archive host is unreachable, the install step can fail even though npm downloaded the JavaScript package.

This example assumes the browser download fails because the installation environment cannot reach its archive host.

npm install puppeteer

How to fix

Fix the network, proxy, trusted certificate or filesystem problem shown in the nested installer error, then rerun installation. If the package is already present, rerun only browser setup.

npx puppeteer browsers install

Things to keep in mind

PUPPETEER_SKIP_DOWNLOAD intentionally skips browser setup; it does not repair the download. Only use it when your deployment supplies a compatible browser separately.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →