October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
Cupertino desk4 min

Which Operating Systems Does Puppeteer Support? Windows, macOS, Linux, and ARM64

Puppeteer lists Chrome for Testing on Windows x64, macOS x64/arm64, and selected Linux distributions on x64/arm64. Firefox has separate OS requirements.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Puppeteer documents Chrome for Testing on Windows x64, macOS x64 and arm64, and Linux x64 and arm64 for Debian/Ubuntu and openSUSE/Fedora. Firefox is also supported, but Puppeteer points to Mozilla for Firefox’s operating-system requirements. A listed platform is not a guarantee that launch will work without the required system libraries, install tools, and a compatible browser version.

Supported operating systems depend on the browser

Puppeteer’s system-requirements page gives an explicit operating-system and architecture matrix for Chrome for Testing. For Firefox, it directs users to Mozilla’s requirements rather than specifying supported OS versions itself. The current Puppeteer documentation identifies both Chrome and Firefox as supported browsers. Puppeteer system requirements; supported browsers.

As an Amazon Associate I earn from qualifying purchases.

Browser Operating systems named Architectures named What to verify
Chrome for Testing Windows; macOS; Debian or Ubuntu Linux; openSUSE or Fedora Linux Windows x64; macOS x64 and arm64; Debian/Ubuntu and openSUSE/Fedora Linux x64 and arm64 The Linux list names specific distribution families; it is not a blanket guarantee for every Linux distribution.
Firefox Puppeteer refers users to Mozilla’s Firefox system requirements rather than listing OS versions Not specified on Puppeteer’s system-requirements page Check Mozilla’s current requirements for the Firefox release you intend to run; don’t infer a minimum OS version from Puppeteer’s Chrome matrix.

Chrome for Testing support began with Puppeteer v20; stable Firefox support began with v23. The Puppeteer documentation describes browser versions as closely paired with Puppeteer releases because browser protocol changes can affect compatibility. Puppeteer FAQ.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Does Puppeteer support ARM64?

Yes, for Chrome for Testing on macOS, Debian/Ubuntu Linux, and openSUSE/Fedora Linux: those platforms are listed with arm64 support. Windows is listed as x64 only. This is a statement about the documented Chrome for Testing matrix, not a claim that every browser, Linux derivative, or Puppeteer deployment supports every ARM64 system.

What you need beyond a supported OS

Runtime and browser pairing

The current system-requirements page specifies Node 22.12 or later. If using TypeScript, it specifies TypeScript 5.0.1 or later and an ES2022-or-later target. Use the browser version paired with your Puppeteer release rather than assuming an arbitrary system-installed browser will work. System requirements; FAQ.

Browser downloads and extraction tools

The puppeteer package normally downloads Chrome for Testing and chrome-headless-shell. Installation scripts blocked by a package manager can prevent that download; use Puppeteer’s documented browser-install command if needed. The puppeteer-core package does not download Chrome, so you must supply a separately managed or remotely hosted browser. Installation.

For browser archives, Puppeteer lists tar.exe or PowerShell on Windows and unzip on macOS/Linux, unless the optional yauzl dependency is installed. Firefox Linux archives require xz or bzip2. These are installation prerequisites, not additional supported operating systems. System requirements.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux libraries and distribution caveats

A Linux browser may fail to launch when required shared libraries are missing. Puppeteer’s troubleshooting guide lists common Debian/Ubuntu dependencies and points to Chrome’s maintained package requirements. Its WSL guidance covers installing missing dependencies. Chrome does not support Alpine out of the box, so Alpine deployments require compatible dependencies and testing; don’t treat them as equivalent to the distributions explicitly listed by Puppeteer. Puppeteer troubleshooting.

Choosing a platform for a deployment

  • Identify whether the job will drive Chrome for Testing or Firefox; their documented OS guidance differs.
  • Match the CPU architecture to the browser’s supported platform entry.
  • For Linux, check whether the distribution family is explicitly named and whether all required libraries are present.
  • Confirm that archive-extraction utilities are available if the browser install needs them.
  • Keep the browser build aligned with the Puppeteer release, especially when managing the browser separately.

Troubleshooting launch and install problems

The browser executable is missing

If you installed puppeteer but no browser is available, an install script may have been blocked. Run the browser-install command documented for your Puppeteer version. If you installed puppeteer-core, provide a browser yourself; that package does not download Chrome. Installation guide.

Linux reports missing shared libraries

Install the dependencies appropriate to your distribution using Puppeteer’s troubleshooting guidance, then retry. A distribution being Linux-based does not ensure it includes Chrome’s required system libraries. For WSL, follow the guide’s dependency instructions; for Alpine, account for the explicit out-of-the-box limitation. Troubleshooting guide.

Browser and Puppeteer behave incompatibly

Check that the browser version corresponds to the installed Puppeteer release. Puppeteer’s releases are paired with browser versions to reduce protocol incompatibilities. FAQ.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Browser archive extraction fails

Check the platform-specific extraction utility: tar.exe or PowerShell on Windows, unzip on macOS/Linux, and xz or bzip2 for Firefox Linux archives. Puppeteer notes that the optional yauzl dependency can replace the usual Chrome archive tool requirement. System requirements.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your goal is a website screenshot rather than running a browser locally, ScreenshotNeo provides a screenshot API and MCP server. One GET request returns an image or PDF; its clean-shot process accepts consent banners and removes known consent platforms, newsletter popups, and chat widgets before capture. Bot checks, blank pages, and failed loads are not billed, and AI agents can use its MCP server.

Example cURL request (replace the URL with the page to capture):

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

See the ScreenshotNeo API documentation for setup and options. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for free screenshots.

Frequently Asked Questions

Which Puppeteer version added stable Firefox support?

Puppeteer’s documentation says stable Firefox support began with v23.

Does puppeteer-core install a browser automatically?

No. It is intended for a separately managed or remotely hosted browser.

Quick Recap

Bestseller No. 1
SaleBestseller No. 2
Bestseller No. 3
SaleBestseller No. 4
SaleBestseller No. 5

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.