digitronik/playwright-vnc repository overview

🎭 PLAYWRIGHT WITH VNC: HEADED BROWSER DOCKER IMAGES

Playwright browser automation with full graphical interface support via VNC.

While Microsoft's official Playwright images excel for headless CI/CD pipelines, they lack graphical user interface capabilities. This project bridges that gap by providing lightweight, VNC-enabled Playwright environments.

✨ KEY FEATURES

• VNC Server Built-in: Connect with any VNC client to view and interact with browsers

• Headed Mode by Default: Designed specifically for visual browser automation

• Multiple Browser Support: Firefox, Chromium, Chrome, and all-in-one variants

• Optimized Images: Multi-stage builds keep images lean while providing full functionality

• Runtime Configurable: Control browser selection and headless mode via environment variables

• Auto-Updated: Daily builds ensure latest Playwright and browser versions

🏷️ AVAILABLE TAGS

Latest Tags (Always Updated):

• digitronik/playwright-vnc:latest - All browsers, latest Playwright

• digitronik/playwright-vnc:firefox-latest - Firefox only, latest version

• digitronik/playwright-vnc:chromium-latest - Chromium only, latest version

• digitronik/playwright-vnc:chrome-latest - Chrome only, latest version

Version-Specific Tags:

• digitronik/playwright-vnc:x.y.z - All browsers with Playwright x.y.z

• digitronik/playwright-vnc:firefox-x.y.z - Firefox with Playwright x.y.z

• digitronik/playwright-vnc:chromium-x.y.z - Chromium with Playwright x.y.z

• digitronik/playwright-vnc:chrome-x.y.z - Chrome with Playwright x.y.z

🚀 QUICK START

Basic Usage:

docker run -p 5900:5900 -p 3000:3000 digitronik/playwright-vnc:latest

Connect via VNC: vncviewer localhost:5900

Environment Variables:

• PW_BROWSER: Select browser (firefox, chromium, chrome)

• PW_HEADLESS: Run in headless mode (true/false, default: false)

🎯 USE CASES

• Visual Testing: Watch tests execute in real-time via VNC

• Debugging: Interactive browser debugging with full GUI access

• Remote Automation: Run browser automation on remote servers with VNC access

• CI/CD with Visual Verification: Combine headless efficiency with visual confirmation

• Training & Demos: Show browser automation in action

📋 PORT MAPPING

• Port 5900: VNC server (for graphical access)

• Port 3000: Playwright server (for automation clients)

🔄 AUTOMATED UPDATES

Images are automatically built daily via GitHub Actions when new Playwright versions are released, ensuring you always have access to the latest features and security updates.

Perfect for developers who need the power of Playwright with the visibility of a graphical interface!

Source: https://github.com/digitronik/playwright-images⁠