Selenium-based solution to serve 1000+ browsers
Alternatives To Gridrouter
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Coc.nvim22,474822636 days ago97September 19, 202241otherTypeScript
Nodejs extension host for vim & neovim, load extensions like VSCode and host language servers.
Whistle11,9491117a day ago539September 13, 202225mitJavaScript
HTTP, HTTP2, HTTPS, Websocket debugging proxy
Nebula11,412303 days ago45June 30, 2022144mitGo
A scalable overlay networking tool with a focus on performance, simplicity and security
3a month ago15January 12, 202235mitJavaScript
System monitoring dashboard for terminal
13 hours ago5August 10, 2022161apache-2.0Go
Open source cloud native security observability platform. Linux, K8s, AWS Fargate and more.
Node Docker Good Defaults2,161
2 months ago7mitJavaScript
sample node app for Docker examples
Flightplan1,789305354 years ago53June 23, 201920mitJavaScript
Run sequences of shell commands against local and remote hosts.
Cloudcmd1,63838513 days ago418July 11, 202222mitJavaScript
✨☁️📁✨ Cloud Commander file manager for the web with console and editor.
3 months ago59mitJavaScript
Watch videos with friends online with the new real time video synchronization platform
Kubectl Node Shell901
2 months ago11apache-2.0Shell
Exec into node via kubectl
Alternatives To Gridrouter
Select To Compare

Alternative Project Comparisons

Selenium Grid Router

Selenium Grid Router is a lightweight server that routes and proxies Selenium Wedriver requests to multiple Selenium hubs.

Golang Implementation

There is a smaller and faster Golang implementation of this server. See aerokube/ggr for more details.

What is this for

If you're frequently using Selenium for running your tests in browsers you may notice that a standard Selenium Grid installation has some faults that can prevent you from using it on large scale:

  • Does not support high availability. Selenium Grid consists of a single entry point hub server and multiple node processes. Users interact only with hub. That means that if for some reason hub goes down all nodes also become unavailable to user.
  • Does not scale well. Our experience shows that even when running on high-end hardware Selenium hub is able to handle correctly no more than 20-30 nodes. When more nodes are connected hub very often stops responding.
  • Does not support authentication and authorization. Standard Selenium grid hub makes all nodes available for everyone.

How it works

The basic idea is very simple:

  1. Define user names and their passwords in a plain text file
  2. Distribute a set of running Selenium hubs (aka "hosts") with nodes connected to each one over multiple datacenters
  3. For each defined user save hosts to a simple XML configuration file
  4. Start multiple instances of Grid Router in different datacenters and load-balance them
  5. Work with Grid Router like you do with a regular Selenium hub


Currently we maintain only Debian packages. To install on Ubuntu ensure that you have Java 8 installed:

# add-apt-repository ppa:webupd8team/java
# apt-get update
# apt-get install oracle-java8-installer

Then install Gridrouter itself:

# add-apt-repository ppa:yandex-qatools/gridrouter
# apt-get update
# apt-get install yandex-grid-router
# service yandex-grid-router start

Configuration files are located in /etc/grid-router/ directory, XML quota files - by default in /etc/grid-router/quota/, log files reside in /var/log/grid-router/, binaries are installed to /usr/share/grid-router.


Two types of configuration files exist:

  • A plain text file with users and passwords (
  • An XML file with user quota definition (<username>.xml)

Users list (

A typical file looks like this:

alice:alicePassword, user
bob:bobPassword, user

As you can see passwords are NOT encrypted. This is because we consider quotas as a way to easily limit Selenium browsers consumption and not a restrictive tool.

User quota definition (<username>.xml)

This file has the following format:

<qa:browsers xmlns:qa="">
    <browser name="firefox" defaultVersion="33.0">
        <version number="33.0">
            <region name="us-west">
                <host name="" port="4444" count="5"/>
            <region name="us-east">
                <host name="" port="4444" count="5"/>
        <version number="37.0">
            <region name="us-west">
                <host name="" port="4444" count="3"/>
                <host name="" port="4444" count="4"/>
            <region name="us-east">
                <host name="" port="4444" count="2"/>
    <browser name="chrome" defaultVersion="42.0">
        <version number="42.0">
            <region name="us-west">
                <host name="" port="4444" count="10"/>
            <region name="us-east">
                <host name="" port="4444" count="10"/>

What we basically do in this file - we enumerate hub hosts, ports and counts of browsers available on each hub. We also distribute hosts across regions, i.e. we place hosts from different datacenters in different <region> tags. The most important thing is to make sure that browser name and browser version have exactly the same value as respective Selenium hub does.


Grid router is using BASIC HTTP authentication. That means that for the majority of test frameworks connection URL would be:

http://username:[email protected]:4444/wd/hub

However some Javascript test frameworks have their own ways to specify connection URL, user name and password.

Hub selection logic

When you request a browser by specifying its name and version Grid Router does the following:

  1. Searches for the browser in user quota XML and returns error if not found
  2. Randomly selects a host from all hosts and tries to obtain browser on that host. Our algorithm also considers browser counts specified in XML for each host so that hosts with more browsers get more connections.
  3. If browser was obtained - returns it to the user and proxies all requests in this session to the same host
  4. If not - selects a new host from another region and tries again. This guarantees that when one datacenter goes down in most of cases we'll obtain browser at worst after the second attempt.
  5. After trying all hosts returns error if no browser was obtained

Hub configuration recommendations

Our experience shows that Grid Router works better with a big set of "small" hubs (having no more than 5 connected nodes) than with some "big" hubs. A good idea is to launch small virtual machines (with 1 or 2 virtual CPUs) containing one Selenium hub process 4-5 Selenium node processes that connect to localhost. This gives us the following profit:

  • Because we have more hubs the probability to successfully obtain browser is greater
  • If each virtual machine has only one browser version installed - it's simpler to increase overall count of available browsers
  • Hubs with small count of connected nodes perform better


We're using Docker and Ansible for integration tests so you need to install them on your Mac or Linux.

Install Boot2docker (dog-nail for Mac users)

  • Install Ansible: brew install ansible
  • Create an empty inventory file: touch /usr/local/etc/ansible/hosts
  • Adjust Python settings: echo 'localhost ansible_python_interpreter=/usr/local/bin/python' >> /usr/local/etc/ansible/hosts
  • Instally Python from official website
  • Install requests with pip: pip install requests[security]
  • Install docker-py: pip install -Iv
  • Run boot2docker: boot2docker up
  • Get Docker VM IP: boot2docker ip
  • Modify /etc/hosts: <boot2docker_ip> boot2docker
  • Add certificates information to console: $(boot2docker shellinit)
  • Export correct host name: export DOCKER_HOST=tcp://boot2docker:2376

Running service locally


  1. Build project: mvn clean package
  2. Start app: ansible-playbook testing/start.yml
  3. Check that container is running: docker ps -a

Run integration tests

$ ansible-playbook testing/test.yml


$ ansible-playbook testing/stop.yml
Popular Nodejs Projects
Popular Hosts Projects
Popular Runtime Environments Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Selenium Grid