{"id":13500595,"url":"https://github.com/zalando/zalenium","last_synced_at":"2025-10-02T14:32:07.444Z","repository":{"id":41176272,"uuid":"69958211","full_name":"zalando/zalenium","owner":"zalando","description":"A flexible and scalable container based Selenium Grid with video recording, live preview, basic auth \u0026 dashboard.","archived":true,"fork":false,"pushed_at":"2021-09-11T10:00:37.000Z","size":14018,"stargazers_count":2381,"open_issues_count":36,"forks_count":577,"subscribers_count":135,"default_branch":"master","last_synced_at":"2024-04-16T14:08:23.045Z","etag":null,"topics":["browserstack","docker","docker-selenium","kubernetes","saucelabs","selenium","selenium-grid","testing","testingbot"],"latest_commit_sha":null,"homepage":"https://opensource.zalando.com/zalenium/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zalando.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2016-10-04T11:23:35.000Z","updated_at":"2024-04-04T17:40:26.000Z","dependencies_parsed_at":"2022-08-10T01:43:00.837Z","dependency_job_id":null,"html_url":"https://github.com/zalando/zalenium","commit_stats":null,"previous_names":[],"tags_count":142,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzalenium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzalenium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzalenium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzalenium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zalando","download_url":"https://codeload.github.com/zalando/zalenium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219875712,"owners_count":16554705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browserstack","docker","docker-selenium","kubernetes","saucelabs","selenium","selenium-grid","testing","testingbot"],"created_at":"2024-07-31T22:01:06.462Z","updated_at":"2025-10-02T14:32:06.785Z","avatar_url":"https://github.com/zalando.png","language":"Java","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg id=\"header\" height=\"214\" width=\"500\" src=\"./docs/img/logo_zalenium_wide.png\" /\u003e\n\n\u003c/p\u003e\n\n[![Build Status](https://travis-ci.org/zalando/zalenium.svg?branch=master)](https://travis-ci.org/zalando/zalenium)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/c719a14f5537488b8fb95d70e27acd5f)](https://www.codacy.com/app/diemol_zalenium/zalenium?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=zalando/zalenium\u0026amp;utm_campaign=Badge_Grade)\n[![codecov](https://codecov.io/gh/zalando/zalenium/branch/master/graph/badge.svg)](https://codecov.io/gh/zalando/zalenium)\n[![GitHub release](https://img.shields.io/github/release/zalando/zalenium.svg)](https://github.com/zalando/zalenium/releases)\n[![Docker Pulls](https://img.shields.io/docker/pulls/dosel/zalenium.svg)](https://hub.docker.com/r/dosel/zalenium/tags/)\n[![Slack](https://img.shields.io/badge/chat-on%20slack-red.svg?logo=slack)](https://seleniumhq.herokuapp.com)\n\n\n# :exclamation: This project is not being developed anymore. We will only reply to issues and to questions in the Zalenium Slack channel.  \n## The last Zalenium release was [3.141.59z](https://github.com/zalando/zalenium/releases/tag/3.141.59z)\n### From now on, we will spend our time just replying to new issues and answering questions at the Zalenium Slack channel. \n### Unfortunately, no new maintainers were found and this project won't be developed anymore.\n### The most relevant features from Zalenium are being/will be implemented in the upstream Grid 4.x, keep an eye on https://github.com/seleniumhq/docker-selenium/. You could migrate to this project in the near future.\n### We want to truly thank all of our users for making this a great project, helping us spread the word and improve the testing community ❤️ This project was made for the community and by the community!\n\n\n--- \n\n\nThis is a Selenium Grid extension to scale your local grid dynamically with docker containers. It uses\n[docker-selenium](https://github.com/elgalu/docker-selenium) to run your tests in Firefox and Chrome locally, if you\nneed a different browser, your tests can get redirected to a cloud testing provider ([Sauce Labs](https://saucelabs.com/), \n[BrowserStack](https://www.browserstack.com/), [TestingBot](https://testingbot.com/), [CrossBrowserTesting](https://crossbrowsertesting.com/), [LambdaTest](https://www.lambdatest.com/)). Zalenium also works out of the box\nin [Kubernetes](https://zalando.github.io/zalenium/#kubernetes).\n\nZalenium's maintainers add new features regularly. We invite you to test it, report bugs, suggest any ideas you may\nhave, and contribute. See our [contributing guidelines](https://zalando.github.io/zalenium/#contributing) for more details.\n\n### Why?\n\n\u003e Thanks for open sourcing this. Our test suite run time has dropped from more than an hour to six minutes. — [@TKueck](https://twitter.com/Tkueck/status/887425829273088000)\n\nWe know how complicated it is to:\n* Have a stable grid to run UI tests with Selenium\n* Maintain it over time (keep up with new browser, Selenium and drivers versions)\n* Provide capabilities to cover all browsers and platforms\n\nThat is why we took this approach where [docker-selenium](https://github.com/elgalu/docker-selenium) nodes are\ncreated on demand. Your UI tests in Firefox and Chrome will run faster because they are running on a local grid,\non a node created from scratch and disposed after the test completes.\n\nIf you need a capability that cannot be fulfilled by [docker-selenium](https://github.com/elgalu/docker-selenium),\nthe test gets redirected to a cloud testing provider ([Sauce Labs](https://saucelabs.com/),\n[BrowserStack](https://www.browserstack.com/), [TestingBot](https://testingbot.com/), [CrossBrowserTesting](https://crossbrowsertesting.com/), [LambdaTest](https://www.lambdatest.com/)).\n\nZalenium's main goal is: to allow anyone to have a disposable and flexible Selenium Grid infrastructure.\n\nPart of the idea comes from this [Sauce Labs post](https://saucelabs.com/blog/introducing-the-sauce-plugin-for-selenium-grid).\n\n### What does **Zalenium** mean?\nAs you can imagine, it is the result of mixing _[Zalando](https://tech.zalando.com)_ and _[Selenium](http://www.seleniumhq.org/)_.\nAs mentioned before, this project's aim is to provide a simple way to create a grid and contribute to the Selenium community.\nNevertheless, this is _**not**_ an official [Selenium](http://www.seleniumhq.org/) project. We kindly ask you to create\n[issues](https://github.com/zalando/zalenium/issues/new) in this repository. If you have questions about how to get\nstarted, please join the #zalenium channel on [Slack](https://seleniumhq.herokuapp.com). \n\n***\n\n## Contents\n\n* [Getting Started](#getting-started)\n  * [Prerequisites](#prerequisites)\n  * [Run it](#run-it)\n* [Additional features](#additional-features)\n* [Documentation](#documentation)\n\n## Getting Started\n\n#### Prerequisites\n* Docker engine running, version \u003e= 1.11.1 (probably works with earlier versions, not tested yet).\n* Make sure your docker daemon is running (e.g. `docker info` works without errors).\n\n* Pull the [docker-selenium](https://github.com/elgalu/docker-selenium) image. `docker pull elgalu/selenium`\n\n* `docker pull dosel/zalenium`\n\n#### Run it\n* Zalenium uses docker to scale on-demand, therefore we need to give it the `docker.sock` full access, this is known as\n\"Docker alongside docker\".\n\n  ```sh\n   # Pull docker-selenium\n    docker pull elgalu/selenium\n\n    # Pull Zalenium\n    docker pull dosel/zalenium\n          \n    docker run --rm -ti --name zalenium -p 4444:4444 \\\n      -v /var/run/docker.sock:/var/run/docker.sock \\\n      -v /tmp/videos:/home/seluser/videos \\\n      --privileged dosel/zalenium start\n  ```\n\n  * Why `--privileged`? We suggest you run Zalenium as `--privileged` to speed up the node registration process by\n      increasing the entropy level with [Haveged](http://www.issihosts.com/haveged/). Using `--privileged` is optional\n      since it is just meant to improve its performance. For more information, check this\n      [tutorial](https://www.digitalocean.com/community/tutorials/how-to-setup-additional-entropy-for-cloud-servers-using-haveged).\n\n* Try also our one line installer and starter for OSX/Linux (it will check for the latest images and ask for missing dependencies.)\n\n  ```sh\n    curl -sSL https://raw.githubusercontent.com/dosel/t/i/p | bash -s start\n  ```\n\n* More usage examples, parameters, configurations, video usage and one line starters can be seen [here](https://zalando.github.io/zalenium/#usage)\n* After the output, you can check the [grid](http://localhost:4444/grid/console) console\n* Now you can point your Selenium tests to [http://localhost:4444/wd/hub](http://localhost:4444/wd/hub)\n* Stop it: `docker stop zalenium`\n\n## Additional features\n* [Dashboard](http://localhost:4444/dashboard), see all the videos and aggregated logs after your tests completed.\n  \u003cp align=\"center\"\u003e\n    \u003cimg id=\"dashboard\" width=\"600\" src=\"docs/img/dashboard.gif\" /\u003e\n  \u003c/p\u003e\n* Live preview of your running tests [http://localhost:4444/grid/admin/live](http://localhost:4444/grid/admin/live)\n\u003cp align=\"center\"\u003e\n  \u003cimg id=\"live-preview\" width=\"600\" src=\"docs/img/live_preview.gif\" /\u003e\n\u003c/p\u003e\n\n* Video recording, check them in the `/tmp/videos` folder (or the one you mapped when starting Zalenium)\n* Customise video file naming via capabilities, basic auth and [more](https://zalando.github.io/zalenium/#usage)\n\n## Documentation\n\nCheck the complete documentation at https://zalando.github.io/zalenium/\n\nLicense\n===================\n\nSee [License](LICENSE.md)\n\n\nSecurity\n===================\n\nSee [Security](SECURITY.md)\n","funding_links":[],"categories":["Java","selenium-grid","测试","Software Development","Resources"],"sub_categories":["UX testing","Containers","IDE/Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzalando%2Fzalenium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzalando%2Fzalenium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzalando%2Fzalenium/lists"}