WebSummoner

WebSummoner is developed and maintained by RIADVICE — a Selenium hub updated with current Go toolchains, modern browser images and community fixes.

WebSummoner is a fast Selenium hub that summons a fleet of browsers into Docker containers — ephemeral, session-scoped environments.

Features

One-command Installation

Start browser automation in minutes by downloading Configuration Manager binary and running just one command:

$ ./cm websummoner start --vnc --tmpfs 128

The legacy cm selenoid subcommand is still accepted. That's it! You can now use WebSummoner instead of Selenium server. Specify the following Selenium URL in tests:

http://localhost:4444/wd/hub

Ready to use Browser Images

No need to manually install browsers or dive into WebDriver documentation. Available images:

New images are added right after official releases. You can create your custom images with browsers.

Live Browser Screen and Logs

New rich user interface showing browser screen and Selenium session logs:

Video Recording

• Any browser session can be saved to H.264 video (example)
• An API to list, download and delete recorded video files

Convenient Logging

• Any browser session logs are automatically saved to files - one per session
• An API to list, download and delete saved log files

Lightweight and Lightning Fast

Suitable for personal usage and in big clusters:

• Consumes 10 times less memory than Java-based Selenium server under the same load
• Small 6 Mb binary with no external dependencies (no need to install Java)
• Browser consumption API working out of the box
• Ability to send browser logs to centralized log storage (e.g. to the ELK-stack)
• Fully isolated and reproducible environment

Detailed Documentation

• Detailed documentation — built from docs-site/ with Astro Starlight, deployed to GitHub Pages by the custom docs workflow
• Compatible with the vast Selenoid community knowledge on StackOverflow

Complete Guide & Build Instructions

Complete reference guide (including building instructions) lives at websummoner.riadvice.com/websummoner (source: docs-site/).

Building requires only Docker — no Go installation on your machine:

$ docker run --rm -v "$PWD":/app -w /app golang:1.27-trixie \
      go test -tags 's3 metadata' -race ./...

Migrating from Selenoid

WebSummoner keeps backwards compatibility with Selenoid client-facing APIs:

• The legacy selenoid:options capability prefix is still accepted (the new websummoner:options takes precedence when both are set)
• The legacy X-Selenoid-No-Wait and X-Selenoid-File headers and the /aerokube/... proxy path fragment still work
• Inside the Docker image the configuration file moved from /etc/selenoid/browsers.json to /etc/websummoner/browsers.json (override with the -conf flag or your own entrypoint)

WebSummoner in Kubernetes

WebSummoner was initially created to be deployed on hardware servers or virtual machines and is not suitable for Kubernetes.

Known Users

WebSummoner runs browser automation for engineering teams all over the world — from startups to Fortune 500 companies — and workflows built for its compatible predecessors carry over unchanged:

License

Apache 2.0 — see LICENSE.