(Created on )

Puppeteer: Platform must be defined

An internal browser-install path received no platform.


An internal browser-install path received no platform.

Error message

Platform must be defined

How this error happens

The provider installation needs a recognized target platform. If automatic detection returns no platform, this operation cannot choose a compatible browser artifact.

The failing command assumes an unsupported OS/architecture or a wrapper that failed to pass its detected platform.

npx puppeteer browsers install

How to fix

For an actual Linux x64 deployment, supply the corresponding target platform explicitly. Otherwise choose the supported platform matching your deployment or use a supported remote browser.

npx puppeteer browsers install chrome \
    --platform=linux

Things to keep in mind

This is a cross-platform download example, not a repair for an unsupported local OS. A Linux binary will not run on macOS or Windows. Public platform validation can reject before the deeper internal message.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →