(Created on )

Puppeteer: Extraction failed: {value}

The native archive extraction process failed.


The native archive extraction process failed.

Error message

Extraction failed: {value}

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

How this error happens

The native extraction command exited unsuccessfully. A truncated browser archive, insufficient disk space or an unwritable destination can cause this.

The command demonstrates the installation workflow; it only fails when the archive or environment has the condition described above.

npx puppeteer browsers install

How to fix

Check the extraction or mount error first, ensure there is enough disk space, and retry package-managed installation into a separate writable cache.

PUPPETEER_CACHE_DIR=/absolute/path/new-browser-cache \
    npx puppeteer browsers install

Things to keep in mind

Use the same cache location when launching. If a mirror supplied the wrong file, restore the trusted browser archive source before retrying. Do not delete a broad cache or unmount an unrelated volume.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →