This is a Selenium Grid extension to scale your local grid dynamically with docker containers. It uses docker-selenium to run your tests in Firefox and Chrome locally, if you need a different browser, your tests can get redirected to a cloud testing provider (Sauce Labs, BrowserStack, TestingBot). Zalenium has also support for Kubernetes.
Zalenium's maintainers add new features regularly. We invite you to test it, report bugs, suggest any ideas you may have, and contribute. See our contributing guidelines for more details.
Thanks for open sourcing this. Our test suite run time has dropped from more than an hour to six minutes. — @TKueck
We know how complicated it is to:
- Have a stable grid to run UI tests with Selenium
- Maintain it over time (keep up with new browser, Selenium and drivers versions)
- Provide capabilities to cover all browsers and platforms
That is why we took this approach where docker-selenium nodes are created on demand. Your UI tests in Firefox and Chrome will run faster because they are running on a local grid, on a node created from scratch and disposed after the test completes.
Zalenium's main goal is: to allow anyone to have a disposable and flexible Selenium Grid infrastructure.
Part of the idea comes from this Sauce Labs post.
What does Zalenium mean?
As you can imagine, it is the result of mixing Zalando and Selenium. As mentioned before, this project's aim is to provide a simple way to create a grid and contribute to the Selenium community. Nevertheless, this is not an official Selenium project. We kindly ask you to post issues or questions through the channels we created for that.
- Getting Started
- Additional features
- Docker version
- Kubernetes version
- How it works
- About the project versioning
- Usage examples
- Docker engine running, version >= 1.11.1 (probably works with earlier versions, not tested yet).
- Pull the docker-selenium image.
docker pull elgalu/selenium
- If you want to use the cloud testing provider integration feature (Sauce Labs, BrowserStack, TestingBot), you will need an account with them.
Set it up
- Make sure your docker daemon is running (e.g.
docker infoworks without errors).
docker pull dosel/zalenium
Zalenium uses docker to scale on-demand, therefore we need to give it the
docker.sock full access, this is known as
"Docker alongside docker".
Basic usage, without any of the integrated cloud testing platforms enabled:
docker run --rm -ti --name zalenium -p 4444:4444 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/videos:/home/seluser/videos \ --privileged dosel/zalenium start
You can also try our one line installer and starter (it will check for the latest images and ask for missing dependencies.)
curl -sSL https://raw.githubusercontent.com/dosel/t/i/p | bash -s start
More usage examples, more parameters, configurations, video usage and one line starters can be seen here
After the output, you should see the DockerSeleniumStarter node in the grid
Now you can point your Selenium tests to http://localhost:4444/wd/hub
docker stop zalenium
- Dashboard, see all the videos and aggregated logs after your tests completed. Check a live demo here
- Live preview of your running tests http://localhost:4444/grid/admin/live
- Video recording, check them in the
/tmp/videosfolder (or the one you mapped when starting Zalenium)
- Customise video file naming via capabilities and more
- Basic auth to protect the grid when deployed to the open internet, instructions to enable basic auth here
For Linux systems you can simply share the docker binary via
-v $(which docker):/usr/bin/docker
docker run --rm -ti --name zalenium -p 4444:4444 \ -v $(which docker):/usr/bin/docker \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/videos:/home/seluser/videos \ --privileged dosel/zalenium start
Zalenium for OSX is currently compatible with Docker
17.09.0-ce. Nevertheless, starting
with 1.13, newer CLIs can talk to older daemons. If you bump into any API compatibility issues, you can explicitly tell
Zalenium which version you are using via
docker run --rm -ti --name zalenium -p 4444:4444 \ -e DOCKER=17.06.2-ce \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/videos:/home/seluser/videos \ --privileged dosel/zalenium start
docker run --rm -ti --name zalenium -p 4444:4444 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /c/Users/your_user_name/temp/videos:/home/seluser/videos \ --privileged dosel/zalenium start
Any feedback or contributions are welcome! Please check our guidelines, they just follow the general GitHub issue/PR flow.
Also, we have adopted the Contributor Covenant as the code of conduct for this project:
Building and Testing
If you want to verify your changes locally with the existing tests (please double check that the Docker daemon is
running and that you can do
mvn clean test
Building the image
mvn clean package cd target docker build -t zalenium:YOUR_TAG .
Running the image you just built
docker run --rm -ti --name zalenium -p 4444:4444 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/videos:/home/seluser/videos \ --privileged zalenium:YOUR_TAG start
Running the integration tests with Sauce Labs or BrowserStack or TestingBot. You will need an account on any of those providers to run them (they have free plans). Or you can just run some of our tests individually from an IDE.
How it works
Zalenium works conceptually in a simple way:
- A Selenium Hub starts and listens on port 4444.
- One custom node for docker-selenium registers to the grid.
- If a cloud testing integration is enabled, a cloud proxy node to support a cloud provider (Sauce Labs, BrowserStack, TestingBot) will register to the grid.
- A test request is received by the hub and the requested capabilities are verified against each one of the nodes.
- If docker-selenium can fulfill the requested capabilities, a docker container is created on the run, and the test request is sent back to the hub while the new node registers.
- The hub acknowledges the new node and routes the the test request with to it.
- The test is executed and the container is disposed after test completion.
- If docker-selenium cannot fulfill the requested capabilities, it will processed by one of the enabled cloud testing platforms.
About the project versioning
- To make life easy for people who want to use Zalenium, we are now using as a version number the Selenium version being supported.
- The major-minor version combined with the patch level will indicate the Selenium version being supported. E.g.
- When a release is
3.8.1a, it supports Selenium 3.8.1
- The badge above shows the latest image version
- Alias for the latest images,
- When a release is
Zalenium in the Selenium Conf Austin 2017
Get a better overview of what Zalenium is and how it works by checking the recorded talk here
Integrated Cloud Testing solutions
- Thanks to the open source accounts we got, we have integrated so far:
If you want to integrate another cloud testing solution, we are happy to receive PRs or requests via issues, don't forget to check the guidelines for contributing.