(Created on )

Puppeteer: Failed to extract {value} to {value}: {value}

Browser archive extraction failed for the named source and destination.


Browser archive extraction failed for the named source and destination.

Error message

Failed to extract {value} to {value}: {value}

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

How this error happens

The named archive could not be unpacked into the chosen destination. Corrupt archive bytes or destination permissions are common causes.

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 →