Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
191 lines (144 sloc) 7.14 KB


Local Grid Setup Guide

This guide will assist you in setting up a local Selenium Grid on your computer with a Selenium Hub, one Selenium Node for Chrome, one Node for Firefox and if you're using a Mac, one Node for Safari.

Table of Content

Step 1 Check latest Chrome and Firefox stable version

The first step is to find out the version of Chrome and Firefox that are installed on your computer.
If Chrome and/or Firefox are not installed, this script will automatically download and install the latest stable releases.

To check the browser versions:
1. Chrome
Open Chrome and enter chrome://settings/help into the address bar.

2. Firefox
Open Firefox, top right menu, then select Help, then About Firefox. You can also find out the latest version at

By default, the local grid setup script is configured for Chrome version 74 and Firefox version 66.
If these are the versions already installed on your computer, you can skip Step 2: configure the script and jump directly to Step 3: install the local grid.


NOTE: This script only works on Windows 10. On Windows 7, several steps needs to be done manually.

Step 2 Configure the script

Now that you know what the latest stable versions of Chrome and Firefox are, please open a command prompt/terminal and enter the following commands.:

Windows 10

cd %KITE_HOME%\scripts\windows
notepad gridConfig.bat


cd $KITE_HOME/scripts/linux


cd $KITE_HOME/scripts/mac
open -a TextEdit

Scroll down to the end of the file and edit the following parameters with the versions corresponding to the latest stable releases versions. Please only input the major (only 74 and not 74.0.3729.6).

rem Browser versions

Different browser versions require a different ChromeDriver (to control Chrome) and a different GeckoDriver (to control Firefox). You will need to find out what are the corresponding driver version. Please visit the following two pages:

And edit the following values in gridConfig.bat accordingly. This time, please input the full version with the minor (74.0.3729.6 and not 74).

rem ChromeDriver and GeckoDriver versions
set GECKO_VERSION=v0.24.0

You might also want to check the Selenium Standalone Server version. At the time of writing this, the latest version was 3.141.59 and was compatible with all recent ChromeDriver and GeckoDriver releases. You can find out the latest Selenium Standalone Server version at:

Now, please save the file gridConfig.bat and you should be all set to run the local grid setup script.

Step 3 Install the local grid

Open a command prompt and enter the following commands:

Windows 10

cd %KITE_HOME%\scripts\windows


cd $KITE_HOME/scripts/linux
chmod +x *.sh


cd $KITE_HOME/scripts/mac
chmod +x *.sh
chmod +x *.command

On Mac, if you see a confirmation window when running the script, just open it with a text editor and click on open, you should then be able to run the script by clicking on it.

Safari setup: Safari is installed by default on MacOS, but in order to be controlled by KITE, you need to enable the 'Allow Remote Automation' option in Safari's Developer menu to control Safari via WebDriver.

The script will open a couple of windows to download and install the browsers, drivers and selenium on your computer. Please wait for all the download and installation to complete as the script asks you, then press a key to launch the grid.

That's it. Congratulation, you have setup a local grid on your computer ready to be used for your tests. Open the Grid Console. You should see two Selenium nodes, one for Firefox and one for Chrome. Local Grid Console

If you have any issue, please check out Explanations and troubleshooting section.


Explanations and troubleshooting

Note: the script file extensions have been omitted in this paragraph, they are respectively .bat on Windows, .sh on Linux and .command on Mac.

The script setupLocalGrid will execute the following scripts in order.


This will create the localGrid/ in your KITE installation directory (%KITE_HOME% on Windows and $KITE_HOME on Linux/Mac).
It will also create the subfolders localGrid/chrome/, localGrid/hub/ and localGrid/firefox/.
Finally, it will also generate the scripts that starts and stop the grid, namely:




This will check which version of Google Chrome is installed on your computer, if it is not the one you specified in your gridConfig, it will install the latest version of Chrome.
This doesn't work on Windows 7. Please download and install Chrome manually from:



This will check which version of Mozilla Firefox is installed on your computer, if it is not the one you specified in your gridConfig, it will install the latest version of Firefox.
This doesn't work on Windows 7. Please download and install Firefox manually from:


This will download the version of chromedriver and selenium driver you specified in your gridConfig, it will then unzip them and move them to the localGrid folder. This doesn't work on Windows 7. Please download and install ChromeDriver and GeckoDriver manually from:


This will download the version of selenium standalone server you specified in your gridConfig and move it to the localGrid folder. This doesn't work on Windows 7. Please download Selenium Standalone Server manually from:

Once all those scripts are over, you will be able to launch the local grid by running the localGrid/startGrid script from the localGrid folder.

You can’t perform that action at this time.