Tried to find the browser at the configured path ({value}), but no executable was found.

How to fix the Puppeteer error: Tried to find the browser at the configured path ({value}), but no executable was found.


Error

Tried to find the browser at the configured path (${executablePath}), but no executable was found.

What it means

Puppeteer raised this from its browser launch code. In practice, it usually means your script reached a browser, page, frame, element, or option state that the API cannot use safely.

How to fix it

  • Install the matching browser revision or point Puppeteer at an existing browser with executablePath.
  • Run npx puppeteer browsers install chrome or reinstall puppeteer so the postinstall download can complete.
  • Check PUPPETEER_CACHE_DIR, PUPPETEER_SKIP_DOWNLOAD, CI cache restores, and container file permissions.

Minimal guard

try {
  // Run the Puppeteer operation that triggers this error.
} catch (error) {
  if (error instanceof Error && error.message.includes("Tried to find the browser at the configu")) {
    // Apply the fix above, then retry or fail with a clearer message.
  }
  throw error;
}

Keep Reading

Puppeteer Guides

All Guides →