DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk6 min

How to Fix Playwright Screenshot Tests Failing in Docker on Ubuntu

Find whether a Docker screenshot failure is a browser launch problem, Chromium crash, missing display, or visual mismatch—and follow the right fix.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start by identifying which failure you have: a browser that will not launch, a Chromium crash, a headed test with no display, or a screenshot that launches successfully but fails its visual comparison. These problems have different fixes. The most reliable first checks are to align the Playwright package, browser binaries, and Docker image; install Linux browser dependencies; and run visual comparisons in the same environment used to create their baselines.

Classify the failure before changing the setup

Read the test output and determine whether the browser started. A missing executable or launch error points to browser installation, version alignment, system dependencies, or display setup. A Chromium process crash points to container runtime or resource conditions. If the page loads and toHaveScreenshot() reports a mismatch, investigate rendering differences and page content instead of treating it as a browser installation problem.

As an Amazon Associate I earn from qualifying purchases.

Failure Evidence to check First step
Browser executable missing or launch error Error text, browser logs, Playwright package and browser versions Align the package and image versions, then install the matching browser and Linux dependencies.
Chromium crashes in the container Browser logs and Docker runtime configuration Check whether --init and --ipc=host fit the symptoms.
Screenshot visual-diff failure Actual and expected images; baseline browser and platform Run in the baseline environment and inspect environmental or page-content differences.
Headed-mode failure on Linux Whether a display server is available Run under Xvfb.

The exact error, browser, Playwright version, Dockerfile, Ubuntu release, and baseline environment determine the diagnosis. Without those details, there is no single root cause to assume.

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

Align the Playwright package, browser, and Docker image

Playwright browser binaries are tied to Playwright releases. If the project package and the Docker image expect different releases, the browser executable may be missing or unavailable. Pin the image version and keep it aligned with the Playwright version installed by the project; do not upgrade blindly just because an example uses a newer version. See the Playwright Docker guidance and browser installation documentation.

#1 Best Overall
Sale
KAMRUI Pinova P2 Mini PC 16GB RAM 512GB SSD, AMD Ryzen 4300U(Beats 5400U/3500U/N95,Up to 3.7GHz,4C/8T) Mini Computers,Triple 4K Display/HDMI+DP+Type-C/WiFi/BT for Home/Business Mini Desktop Computers
  • 【AMD Ryzen 4300U True 4-Core CPU: Outperforms N95 & i3-10110U】KAMRUI P2 Mini PC is equipped with true 4-core AMD Ryzen 4300U processor built on advanced 7nm Zen2 architecture,This means you get consistent, unthrottled performance for hours on end, whether you’re running multiple browser tabs, streaming 4K content, or managing virtual machines. Compare that to Intel N95 (4 efficiency cores that throttle under load) or Intel i3-10110U (only 2 cores total), and the difference is night and day: The KAMRUI P2 AMD Ryzen 4300U (28W) is 40% faster than the Intel i3-10110U and 25% faster than the Intel N95 in multi-core tasks, ensuring smooth, lag-free performance even during heavy workloads.
  • 【Integrated AMD Radeon Graphics: 2.5X Stronger for Tri 4K】The KAMRUI P2 AMD 4300U Mini PC have unlocked the full potential of the built-in AMD Radeon Vega 5 graphics with 28W power delivery, making it 2.5 times stronger than the Intel UHD graphics found in the N95 and i3-10110U. This means you can enjoy Tri 4K@60Hz displays without a single stutter, perfect for productivity setups, home theaters, or even light photo/video editing and casual gaming. While the Intel N95/i3-10110U struggle to run a single 4K display without lag, The KAMRUI AMD 4300U Mini PC handles Tri 4K effortlessly, turning your workspace into a high-efficiency hub or your living room into a premium entertainment center.
  • 【Large Storage Capacity, Easy Expansion】KAMRUI Pinova P2 mini computers is equipped with 16GB LPDDR4 for faster multitasking and smooth application switching. 512GB M.2 SSD ensures fast startup, fast file transfers and plenty of storage space,eliminating slow loading times and ensuring fast responsiveness. the two storage slots (1x M.2 2280 SATA/NVMe PCIe3.0 slot, 1x M.2 2280 SATA slot) can be combined to provide up to 4TB of total storage(Not included). This gives you enough space for all your projects, media and data.
  • 【4K Triple Display】KAMRUI Pinova P2 4300U mini desktop computers is equipped with HDMI2.0 ×1 +DP1.4 ×1+USB3.2 Gen2 Type-C ×1 interfaces for faster transmission, Triple 4K@60Hz Display, KAMRUI P2 mini computer is ideal for visual home entertainment, home office, conference rooms, etc. USB3.2 Gen2 Type-A port ×2 with a transfer speed of up to 10 Gbps (21 times faster than USB 2.0) for efficient data transfer. Ideal for seamless multitasking between spreadsheets, browsers and presentations, or for an immersive entertainment experience.
  • 【USB3.2 Gen2 Type-C 10Gbps, Versatile connectivity】KAMRUI P2 mini desktop pc fast and versatile connectivity! The USB3.2 Gen2 Type-C port offers a data transfer rate of 10Gbps and simultaneously supports DisplayPort 1.4 video output. The P2 AMD Ryzen 4300U Mini PC is complemented by Gigabit LAN, WiFi and Bluetooth, so nothing stands in the way of a productive working environment.
  1. Check the project version with npx playwright --version.
  2. Use a Playwright Docker image tag that matches that version, or install the browser binaries for the project’s pinned version in your custom image.
  3. Install the browser your tests use and the Linux system dependencies it needs.
  4. Rebuild the image after changing its browser or dependency installation, then rerun the failing test.

For a custom image, Playwright’s Docker documentation says it needs Node.js, the browser binaries, and the browser system dependencies. The following is an example pattern from the documentation; replace 1.63.0 with the project’s actual Playwright version:

FROM node:20-bookworm
RUN npx -y [email protected] install --with-deps

That command installs browsers and dependencies for the specified Playwright release. If you only need Chromium, the browser guide documents npx playwright install --with-deps chromium. Installation and dependency checks are described in the browser guide.

Install missing Ubuntu browser dependencies

Installing a browser binary alone may not be enough on Linux: browser processes also rely on operating-system packages. Use Playwright’s install command with dependencies when building the image, or install the dependencies for the browser you run. The CLI supports dry-run inspection before installation:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
npx playwright install --dry-run
npx playwright install-deps --dry-run

On Linux, the dependency dry run simulates the package installation actions and exits nonzero if packages are missing. This can help distinguish an incomplete dependency setup from a visual assertion failure. See the Playwright command-line documentation.

Check Docker runtime settings for Chromium crashes

These options address container process or Chromium memory concerns; they are not general fixes for screenshot pixel differences. For relevant Chromium-in-Docker symptoms, try the documented runtime settings:

Rank #2
Sale
GMKtec G3S Mini PC Intel N95 Processor (Up to 3.4GHz) 8GB RAM 256GB M.2 SSD | Mini Desktop Computer with VESA Mount for Office Home Business HTPC Proxmox, Dual 4K Display, WiFi 5, Gigabit Ethernet
  • 12th Intel Alder Lake N95 Processor – The GMKtec G3 S Mini PC is powered by the 12th Gen Intel N95 processor with 4 cores, 4 threads, 6MB cache and a burst frequency up to 3.4GHz. Compared with N100/N5105/N5100/N5095, the N95 delivers up to 36% overall performance improvement. Perfect for routine tasks, office work, and home entertainment, this compact mini desktop is more convenient than traditional bulky PCs.
  • 8GB RAM & 256GB SSD Storage – Pre-installed with 8GB DDR4 memory and a fast 256GB M.2 2242 SSD, the G3 S mini desktop offers quicker startup, smoother multitasking, and faster file transfers. Enjoy seamless performance whether you’re working on multiple applications, browsing, or streaming content.
  • Rich Interfaces & Connectivity – The G3 S mini computer comes equipped with USB 3.2 (up to 10Gbps), dual HDMI 2.0 (4K@60Hz), and a 3.5mm audio jack. With support for WiFi 5, Bluetooth 5.0, and Gigabit Ethernet (RJ45 1000MbE), it connects easily with monitors, projectors, printers, office equipment, and other peripherals, making it versatile for both home and business use.
  • Dual 4K Display Support – Featuring upgraded Intel UHD Graphics (up to 1000MHz), the G3 S supports 4K video playback and AV1 decoding for a smooth viewing experience. With dual HDMI outputs, you can connect two 4K@60Hz displays simultaneously, enabling efficient multitasking for work and entertainment.
  • GMKTEC WARRANTY - GMKtec offers a 3-year limited warranty (1 year replacement + 2 years parts replacement) for each mini PC, starting from the date of the purchase effective on all sales starting Oct. 2026. All defects due to design and workmanship are covered. With a professional after sales team always ready to attend to your needs, you can simply relax and enjoy your mini PC
docker run --init --ipc=host ...
  • --init provides an init process to help handle PID 1 and zombie-process behavior.
  • --ipc=host can reduce Chromium memory-related crashes by changing the container’s shared-memory setup.

For unusual Chromium launch errors during local development, Playwright’s Docker guide also suggests trying --cap-add=SYS_ADMIN. Treat it as a diagnostic option for that situation, not a routine requirement or a remedy for visual diffs. Refer to the Docker guide for the context behind these settings.

Make visual screenshot comparisons repeatable

A visual mismatch does not necessarily mean the application changed. Playwright notes that rendering can vary with host OS, browser version, settings, hardware, power source, headless mode, and other conditions. Different browsers and platforms can also render fonts and pages differently. Generate and compare baselines in the same environment whenever possible; if you test multiple browser-platform combinations, maintain baselines for the combinations you intend to support. See Visual comparisons.

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

Inspect the baseline and the actual screenshot

  • Confirm the baseline was created with the same browser and platform as the failing run.
  • Check whether the Docker image, browser version, headless mode, or fonts differ from the baseline environment.
  • Inspect the actual and expected images to determine whether the difference is a genuine UI change, rendering drift, or volatile page content.

Use screenshot assertions and update snapshots deliberately

Playwright’s toHaveScreenshot() assertion captures until two consecutive screenshots match before saving a new reference. Keep snapshot files under version control and review changes. If the UI change is intentional, update the reference with:

npx playwright test --update-snapshots

Review the resulting image diffs before accepting them. Updating snapshots is not a substitute for diagnosing unexpected changes.

Handle genuinely volatile regions carefully

For content that is intentionally outside the visual contract—for example, a region that changes independently of the UI being tested—Playwright supports a stylePath stylesheet option to hide volatile content during comparison. Use it narrowly: hiding content that should be tested can conceal regressions. The options and baseline workflow are documented in Visual comparisons.

Rank #3
Glorlin Mini PC, AMD Ryzen 5 3501U CPU (Beats N95, Up to 3.7 GHz, 4C/8T) Small Desktop Computer 16GB DDR4 RAM 512GB NVMe SSD WiFi 6 Bluetooth 5.3 Dual HDMI DP Support Three 4K Display for Home Office
  • 【Great power in a small computer】Get fast performance from the Ryzen 5 3501U ​processor (2.1GHz-3.7GHz, 4 Cores 8 Threads) inside this mini pc, TDP 15W up to 25W. It's perfect for all your home office​ and business use, like daily computing, web browsing, and smooth media streaming. This small desktop computer​ handles everyday tasks easily and quietly.
  • 【Work on many things at once with lots of storage】This mini PC comes with 16GB of fast DDR4 RAM (expandable up to 32GB), allowing you to smoothly run multiple programs, dozens of browser tabs, and large files all at once. It also features a spacious 512GB SSD that provides ample storage and delivers dramatically faster boot-ups, app launches, and file transfers compared to a traditional hard drive.
  • 【See everything clearly on three 4K screens】Connect three monitors for more space to work or play. 1*Type-C 3.2 DP+DATA+PD and 2*HDMI ports​ on this mini pc​ support super sharp 4K Ultra HD​ video. It's great for doubling your work area for business​ or watching movies in high definition.
  • 【Fast modern connections in a tiny box】Enjoy a better and more stable internet connection with the latest WiFi 6. Use Bluetooth 5.3​ to connect wireless headphones, keyboards, and mice without wires. This small pc​ is very compact​ to save desk space and has extra USB ports (2*USB3.2, 2*USB 2.0, 1*Type-C 3.2 DP+DATA+PD, 1*Type-C 2.0, 2*HDMI 4K60Hz) for your printer, webcam, or other computer accessories.
  • 【Ready to use, saves space, and runs quiet】This mini desktop computer comes with the OS 11 Pro operating system pre-installed, so you can set it up and start using it immediately. Its compact, small form factor not only saves valuable desk space but also operates very quietly, ensuring it won't distract you whether you're working, studying, or streaming media.

Collect browser launch diagnostics

Enable Playwright browser logging to see more detail about launch failures:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
DEBUG=pw:browser npx playwright test

If you run headed tests on Linux, a display server is needed. Use Xvfb, for example:

xvfb-run npx playwright test

Playwright documents Xvfb for headed Linux runs and notes that its Docker image and GitHub Action include it. See the continuous integration guidance.

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

Troubleshooting by symptom

“Executable doesn’t exist” or browser cannot be found

Check the project’s Playwright version against the image and installed browser version. Install the browser binaries for the project’s version, and rebuild the image. A browser installed for a different Playwright release may not be available where the test expects it.

Browser fails to start in Ubuntu

Check that the selected browser’s Linux system dependencies are installed. Use npx playwright install --with-deps chromium for Chromium, or the appropriate browser install command. Then collect DEBUG=pw:browser output to narrow down the launch failure.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
C4 SE Mini PC, Ryzen 5 3500U (up to 3.7GHz), 8GB DDR4 256GB NVMe SSD
  • 【Ryzen 5 3500U Processor】Equipped with Ryzen 5 3500U 4-core 8-thread processor with a max boost of 3.7GHz and integrated Radeon Vega 8 graphics, this ORIGIMAGIC mini PC delivers stable and responsive computing power. Perfectly handles daily office work, 4K video playback, casual gaming and light multimedia creation.Advanced features like Auto Power On, RTC Wake, and Wake-on-LAN make it ideal for business, kiosks, digital signage, and remote management
  • 【8GB DDR4 & 256B SSD & Expandable】The Mini computer is equipped with 8GB DDR4 2400MT/s SO-DIMM memory, dual SO-DIMM slots expandable up to 32GB. Pre-installed 256GB M.2 2280 PCIe3.0 NVMe SSD; extra M.2 2280 PCIe3.0 ×1 slot reserved for storage expansion. Whether for daily office work, entertainment, or creation, the Mini PC can deliver excellent performance and ample storage.
  • 【4K@60Hz Triple Display & Full-Featured Ports】Featuring HDMI 2.0, DP and USB-C interfaces, this mini computer supports simultaneous output of three 4K@60Hz monitors. It not only greatly boosts multitasking efficiency, but also delivers an immersive visual experience for movies and gaming. Rich USB 3.2 high-speed ports and 3.5mm audio jack fully meet your daily peripheral connection and high-speed transmission needs.
  • 【Dual Gigabit LAN, WiFi 5 & Bluetooth 5.0】This mini PC is equipped with dual RJ45 gigabit Ethernet ports, dual-band WiFi 5 and Bluetooth 5.0. It provides ultra-stable network transmission for 4K streaming, online meetings and large file transfers. The stable wireless connection supports fast pairing with Bluetooth keyboards, headsets and speakers, and it can also be used as a soft router and home server for diverse usage scenarios.
  • 【Multiple interface configurations】This computer provides a rich interface configuration to meet the connection needs of multiple scenarios, 2×USB3.2 Gen2 10Gbps, 1×USB3.2 Gen1, 1×USB2.0, 3.5mm TRRS audio jack. Dual RTL8111H Gigabit Ethernet RJ45 ports, ideal for soft routing, network monitoring, office and home network setup. Comes with clear CMOS reset hole and LED power button for convenient operation.

Chromium exits or crashes inside Docker

Inspect browser logs and container runtime settings. Try --init for process handling and --ipc=host for applicable Chromium memory crashes. These options will not correct a browser-version mismatch or an image-diff assertion.

Headed tests fail but headless tests work

Confirm that a display server is available in the Linux container. Run the headed suite with xvfb-run npx playwright test.

The test runs, but the image differs from its snapshot

Compare the test and baseline environments, including browser, OS, fonts, and headless mode. Inspect the actual and expected images, then determine whether the change is intentional. Update snapshots only after review.

The image changes between runs

Check for dynamic page content and environmental drift. If a region is intentionally volatile and outside the test’s visual contract, use the documented stylePath option narrowly to exclude it from comparison.

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

Or skip the browser setup

If your goal is to capture a website rather than run a Playwright test, ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return a PNG, JPEG, WebP, or PDF. For example, with the API documentation for options and response details:

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

ScreenshotNeo accepts cookie and consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each cleanup step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing status. Its MCP server offers take_screenshot, get_page_info, and capture_pdf for AI agents and MCP clients. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots.

Sign up for ScreenshotNeo free: 1,000 screenshots a month, no card required.

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 *

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
Crashes, No Sound, or Screen Glitches?Free driver scan

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.