(Created on )

Puppeteer: Extraction failed: Required native binary ('tar.exe' or 'unzip') was not found in the s...

Archive extraction cannot find a required native tar.exe/unzip tool.


Archive extraction cannot find a required native tar.exe/unzip tool.

Error message

Extraction failed: Required native binary ('tar.exe' or 'unzip') was not found in the s...

How this error happens

A minimal environment can lack the native archive tools used to unpack a browser. Downloading a ZIP is not enough if no supported extractor is available.

The failing command assumes the installer cannot find the native archive tool required by that format.

npx puppeteer browsers install

How to fix

On a Debian/Ubuntu build host, install the required extraction utility before retrying.

apt-get update

apt-get install -y unzip

npx puppeteer browsers install

Things to keep in mind

Provision OS tools in the image-build phase. On Windows, check that the required tar.exe is present and reachable through PATH. Do not disable archive validation.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →