Supported browsers

WebSummoner launches any Docker image that speaks WebDriver, but the maintained images below are the recommended path: pinned browser versions, matching drivers, VNC and audio support baked in.

Browser	Image	Current version	WebDriver
Google Chrome	`websummoner/chrome`	152.0.7977.75	ChromeDriver 152.0.7977.75
Mozilla Firefox	`websummoner/firefox`	155.0.0	geckodriver 0.37.1
Microsoft Edge	`websummoner/edge`	152.0.4191.62	msedgedriver 152.0.4191.62
Brave	`websummoner/brave`	1.94.119	ChromeDriver (Chromium core)
Yandex Browser	`websummoner/yandex`	26.6.1.1083	YandexDriver
Opera	`websummoner/opera`	135.0.5973.76	OperaDriver 151.0.7922.176
WebKit (Safari engine)	`websummoner/safari`	2.52.6	WebKitWebDriver — see WebKit

Every image embeds a VNC server; there are no separate vnc_* image variants. Turn the live screen on per session with the enableVNC capability, or set ENABLE_VNC=true in the container environment.

Image tags

Each browser publishes three tag levels, so you can pin as loosely or as tightly as you like:

Level	Example	Meaning
line	`chrome:152`	floats — rebuilt with the newest patch of that line
major.minor	`chrome:152.0`	compatibility alias
full	`chrome:152.0.7977.75`	immutable, driver-matched pin

Ready-made images

docker pull websummoner/chrome:152.0.7977.75
docker pull websummoner/firefox:155.0.0
docker pull websummoner/edge:152.0.4191.62
docker pull websummoner/brave:1.94.119
docker pull websummoner/yandex:26.6.1.1083
docker pull websummoner/opera:135.0.5973.76
docker pull websummoner/safari:2.52.6

All images are free to use and published on Docker Hub. A minimal browsers.json for two of them:

{
  "chrome":  { "default": "152.0.7977.75",
               "versions": { "152.0.7977.75": { "image": "websummoner/chrome:152.0.7977.75",  "port": "4444" } } },
  "firefox": { "default": "155.0.0",
               "versions": { "155.0.0": { "image": "websummoner/firefox:155.0.0", "port": "4444" } } }
}

Known limitations

Chrome, Firefox, Edge, Brave and Yandex pass the whole container test suite. Two engines do not, for reasons outside WebSummoner’s control.

Opera

Opera’s driver is numbered by the Chromium version Opera is built on, not by Opera’s own — Opera 135 is Chromium 151 — so the image pairs it with OperaDriver 151. The full suite passes.

Opera sometimes ships before the driver for its Chromium line exists. The build then falls back to the newest OperaDriver rather than a chromedriver: the version check only warns, and Opera patches its Chromium in ways only its own driver accounts for.

WebKit (Safari)

The safari image is WebKitGTK — the same engine as Safari, built for Linux — driven by WebKitWebDriver. It is the closest you can get to Safari without Apple hardware, but WebKitWebDriver is less complete than the Chromium and Gecko drivers. File upload works — WebSummoner copies uploaded files directly into the browser container. addCookie works provided the cookie sets sameSite (Chromium and Gecko default it; WebKit drops the cookie without it), and the proxy capability works because WebSummoner translates it into the environment GLib’s proxy resolver reads — WebKit itself ignores the capability. Remaining known gaps:

Area	Behaviour
Frames and windows	switching frames can raise `StaleElementReferenceException`
Closing a window	`close()` ends the whole session; use one window per session

WebKitGTK is also sensitive to host load: run it on an otherwise idle grid for stable results.

Custom images

The images repository contains the Dockerfiles and the public images build tool for producing custom browser images. Audio, video recording, VNC, clipboard and file exchange work out of the box in the official images — and in any image built from these Dockerfiles.

← Features Home Ecosystem →