What are Puppeteer environment variables?

Puppeteer looks for certain environment variablesA dynamically named value that can affect the way running processes will behave on a computer. to aid its operations. If Puppeteer doesn’t find them in the environment during the installation step, a lowercased variant of these variables will be used from the npm config.

Puppeteer is a Node library that provides a high-level API to control headless Chrome or Chromium browsers over the DevTools Protocol. Read more here.

Environment variables

Env variable Description
HTTP_PROXY, HTTPS_PROXY, NO_PROXY Defines HTTP proxy settings that are used to download and run Chromium.
PUPPETEER_SKIP_CHROMIUM_DOWNLOAD Do not download bundled Chromium during the installation step.
PUPPETEER_CHROMIUM_REVISION Specify a version of Chromium you’d like Puppeteer to use.
PUPPETEER_EXECUTABLE_PATH Specify an executable path to be used in puppeteer.launch.
PUPPETEER_PRODUCT Specify which browser you’d like Puppeteer to use. Must be one of chrome or firefox. It can also be used during installation to fetch the recommended browser binary.

Beware

Puppeteer is only guaranteed to work with the bundled Chromium. Therefore, use PUPPETEER_CHROMIUM_REVISION and PUPPETEER_EXECUTABLE_PATH env variables at your own risk.

Note: PUPPETEER_* env variables are not accounted for in the puppeteer-core package.

Free Resources

Copyright ©2026 Educative, Inc. All rights reserved