Skip to content

cli: warn when /dev/shm is small and --disable-dev-shm-usage is omitted - #17488

Open
connorjclark wants to merge 1 commit into
mainfrom
warn-dev-shm
Open

connorjclark wants to merge 1 commit into
mainfrom
warn-dev-shm

Conversation

@connorjclark

Copy link
Copy Markdown
Collaborator

Summary
Logs a CLI warning on Linux when /dev/shm is <= 64MB (the default shared-memory allocation in Docker, Kubernetes, and many CI containers) and --disable-dev-shm-usage is not present in --chrome-flags, advising users to pass --disable-dev-shm-usage or increase /dev/shm size to prevent Chrome renderer crashes (TARGET_CRASHED) and PROTOCOL_TIMEOUT hangs. When --port is specified, the check only runs if chrome-launcher spawned a new Chrome instance rather than attaching to an already-running browser.

Also updates documentation (docs/headless-chrome.md, docs/running-at-scale.md, docs/variability.md, and docs/puppeteer.md) with container /dev/shm guidance and a note against concurrent Puppeteer/Playwright CDP control on the audited tab during gathering.

Related Issues/PRs
Refs #6512

@connorjclark
connorjclark requested a review from a team as a code owner November 4, 2026 00:22
@connorjclark
connorjclark requested review from paulirish and removed request for a team November 4, 2026 00:22

This branch was successfully deployed

1 active deployment
Preview — f742dde4 Deployed Nov 4, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant