<titledata-rh="true">Configuration | Puppeteer</title><metadata-rh="true"name="viewport"content="width=device-width,initial-scale=1"><metadata-rh="true"name="twitter:card"content="summary_large_image"><metadata-rh="true"property="og:url"content="https://pptr.dev/next/guides/configuration"><metadata-rh="true"name="docsearch:language"content="en"><metadata-rh="true"name="docsearch:counter"content="3"><metadata-rh="true"property="og:title"content="Configuration | Puppeteer"><metadata-rh="true"name="description"content="All defaults in Puppeteer can be customized in two ways:"><metadata-rh="true"property="og:description"content="All defaults in Puppeteer can be customized in two ways:"><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://pptr.dev/next/guides/configuration"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/next/guides/configuration"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/next/guides/configuration"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://DVKY664LG7-dsn.algolia.net"crossorigin="anonymous"><linkrel="search"type="application/opensearchdescription+xml"title="Puppeteer"href="/opensearch.xml">
as <code>HTTPS_PROXY</code>).</p></div></div><divclass="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><divclass="admonitionHeading_tbUL"><spanclass="admonitionIcon_kALy"><svgviewBox="0 0 16 16"><pathfill-rule="evenodd"d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</div><divclass="admonitionContent_S0QG"><p>Puppeteer's configuration files and environment variables are ignored by <code>puppeteer-core</code>.</p></div></div><h2class="anchor anchorWithStickyNavbar_LWe7"id="configuration-files">Configuration files<ahref="#configuration-files"class="hash-link"aria-label="Direct link to Configuration files"title="Direct link to Configuration files"></a></h2><p>Configuration files are the <strong>recommended</strong> choice for configuring Puppeteer.
Puppeteer will look up the file tree for any of the following formats:</p><ul><li><code>.puppeteerrc.cjs</code>,</li><li><code>.puppeteerrc.js</code>,</li><li><code>.puppeteerrc</code> (YAML/JSON),</li><li><code>.puppeteerrc.json</code>,</li><li><code>.puppeteerrc.yaml</code>,</li><li><code>puppeteer.config.js</code>, and</li><li><code>puppeteer.config.cjs</code></li></ul><p>Puppeteer will also read a <code>puppeteer</code> key from your application's
<code>package.json</code>.</p><p>See the <ahref="/next/api/puppeteer.configuration"><code>Configuration</code></a> interface for possible
options.</p><divclass="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><divclass="admonitionHeading_tbUL"><spanclass="admonitionIcon_kALy"><svgviewBox="0 0 16 16"><pathfill-rule="evenodd"d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</div><divclass="admonitionContent_S0QG"><p>After adding a configuration file, you may need to remove and reinstall
<code>puppeteer</code> for it to take effect if the changes affect installation.</p></div></div><h3class="anchor anchorWithStickyNavbar_LWe7"id="examples">Examples<ahref="#examples"class="hash-link"aria-label="Direct link to Examples"title="Direct link to Examples"></a></h3><h4class="anchor anchorWithStickyNavbar_LWe7"id="changing-the-default-cache-directory">Changing the default cache directory<ahref="#changing-the-default-cache-directory"class="hash-link"aria-label="Direct link to Changing the default cache directory"title="Direct link to Changing the default cache directory"></a></h4><p>Starting in v19.0.0, Puppeteer stores browsers in <code>~/.cache/puppeteer</code> to
about the ambient environment is needed (in this case, <code>__dirname</code>).</p></div></div><h2class="anchor anchorWithStickyNavbar_LWe7"id="environment-variables">Environment variables<ahref="#environment-variables"class="hash-link"aria-label="Direct link to Environment variables"title="Direct link to Environment variables"></a></h2><p>Along with configuration files, Puppeteer looks for certain
<ahref="https://en.wikipedia.org/wiki/Environment_variable"target="_blank"rel="noopener noreferrer">environment variables</a> for
customizing behavior. Environment variables will always override configuration
file options when applicable.</p><p>The following options are <em>environment-only</em> options</p><ul><li><code>HTTP_PROXY</code>, <code>HTTPS_PROXY</code>, <code>NO_PROXY</code> - defines HTTP proxy settings that are
used to download and run the browser.</li></ul><p>All other options can be found in the documentation for the
