dieters877565/chromedriver repository overview

⁠Chromedriver Headless Docker Image

A minimal Debian-based Docker image with Chromium and Chromedriver pre-installed, tailored for automated browser testing, web scraping, and PDF generation. Ideal for use in CI/CD pipelines, headless environments, or with optional VNC remote desktop access.

⁠🧰 Features

• ✅ Chromium + Chromedriver pre-installed
• 🖥️ Supports headless mode and virtual display (Xvfb)
• 🔐 Non-root operation for improved security
• 🖧 Optional VNC access (port 5900) for visual debugging
• 📦 Compatible with both x86_64 and ARM architectures
• ⚙️ Can be used as a remote Chrome instance for BiDi2PDF⁠
• 🧪 Optimized for browser automation (e.g., Selenium, Puppeteer)

⁠🚀 Quick Start (Docker Compose)

services:
  remote-chrome:
    image: dieters877565/chromedriver:latest
    environment:
      ENABLE_XVFB: true       # Enables virtual framebuffer
      ENABLE_VNC: true        # Enables VNC server
      VNC_PASS: supersecret   # Set your VNC access password
    ports:
      - 5900:5900             # Exposes VNC port (optional)

⁠🛠️ Environment Variables

⁠📎 Example Use Cases

• 🧪 CI/CD browser testing (Selenium, Playwright, Puppeteer)
• 📰 Web scraping with Chromium in headless mode
• 📄 PDF generation from HTML
• 🧩 Remote Chrome for BiDi2PDF⁠
• 👁️ Debugging tests via VNC

⁠📌 Notes

• The image is non-root by default.
• Chromium runs with all required dependencies included.
• Port 5900 must be exposed to access the VNC interface externally.

⁠🧑‍💻 Maintainer

Dieter S.
DockerHub Profile⁠

⁠📄 License

MIT License