Phi Nguyen is a QA engineer with 11+ years of experience . His areas of experience include manual testing, automation testing, acceptance testing, regression testing, database testing, API testing and web/mobile apps testing. He currently works full time as a freelancer.

Become a JMeter and Continuous Testing Pro

Start Learning

Test Your Website Performance NOW! |

arrowPlease enter a URL with http(s)
Jun 20 2018

How to Install Gatling on Windows

Gatling is a powerful load testing tool for writing tests in Scala. You can read about Gatling’s abilities in the blog post “8 Reasons You Should Use Gatling for Load Testing”. The purpose of this blog is to show you how to install Gatling on your Windows machine, so you can start your load testing.


Let’s get started.


Install JDK

1. Go to Java SE Downloads on Oracle.

2. Currently Gatling only supports JDK8 so select the "JDK Download" of JDK8.


installing gatling


3. Select the "Accept License Agreement" radio button.


how to install gatling


4. Select the appropriate installation. In this case, it is the 'Windows-64' bit. Click the appropriate link and save the .exe file to your disk.


gatling installation guide


5. Run the downloaded exe file to launch the Installer wizard. Click 'Next' to continue.


gatling installation tutorials


6. At this step you can select optional features to install, such as: install/don’t install “Source Code”, “Public JRE” or change the default installation folder of jdk8. But we will leave the default option that installs development tools+source code+public jre, and click 'Next'.


installing gatling on windows


The installer will be extracted and the progress will be shown in the wizard.


how to install gatling on windows


7. Change the default installation folder of jre8 if you want to, but we recommend leaving the default and click 'Next'.


gatling installation on windows guide


The installer will now install jre8 and the new files will be copied to the installation folder chosen above.


gatling installation on windows tutorial


A successful installation looks like this:


step by step gatling installation


8. This step we will set the environment variable for java. Right-click on “My Computer” and select “Properties”. Click the “Advanced system settings” button like the screenshot below:


learning to install gatling


9. Under the 'Advanced' tab, choose the “Environment Variables…” button.


getting started with gatling


10. If we want the environment variable for java to be used only by the current windows user, go to the User Variables for <user> section. If we want the environment variable for java to be used by all windows users, go to the System variables section. In this example we will choose the System variables and click on the  “New...” button, as shown below:


gatling first steps


11. Type in “Variable name” and “Variable value” with the variable name as the name of the environment variable for java and the variable value as the path directory of jdk8.

  • Variable name: JAVA_HOME
  • Variable value: C:\Program Files\Java\jdk1.8.0_171


gatling and java


Then we have:


java version for gatling


12. Click on the “Path” variable as shown below.


setting installation variables, gatling


13. Add a new line and type in %JAVA_HOME%\bin.


gatling, open source, installation


14. To verify the success of the installation, go to the command prompt and type 'java' as a command. The output of the command should look like below. If the Java installation is unsuccessful or if it had NOT been installed, it will throw an "unknown command" error.


gatling installation verification


Install Gatling

1. Go the the download section on the Gatling website and click on the button “DOWNLOAD NOW!”. Note that the latest release is now Gatling 2.3.1.


downloading gatling


There is no specific installer or exe file for Gatling. Only the bundles that need to be downloaded and unzipped.


2. After completing the download, unzip the zip file ( and copy all items to another folder. In this example I copied all items to a folder named gatling-charts-highcharts-bundle-2.3.1 in the C driver.


load testing installation


3. This step we will set the environment variable for Gatling. Right-click on “My Computer” and select “Properties”. Click the “Advanced system settings” button.


open source load testing, gatling

4. Under the 'Advanced' tab, choose the “Environment Variables…” button.


gatling environment variables


5. Like before, we will choose the System variables:


gatling, system variables

6. Type in the “Variable name” and “Variable value”. The variable value is the Gatling path directory.  

  • Variable name: GATLING_HOME
  • Variable value: C:\gatling-charts-highcharts-bundle-2.3.1


gatling open source getting started


Then we have:


gatling frameworn installation windows

8. Click on the “Path” variable as shown below.


gatling testing installation


9. Add a new line and type in %GATLING_HOME%\bin.


gatling installation easy

Congratulations! You now have Gatling installed! You can now start out with your first Gatling load test. You can start by recording scenarios, customizing the scripts to meet your purposes and executing them.


Here is a quick explanation:


Recording Your Gatling Scripts

1. Go to the bin folder (in this example C:\gatling-charts-highcharts-bundle-2.3.1\bin).


2. Double click on the “recorder.bat” file.


gatling recording scripts


3. A command prompt window will be displayed.


recording your first gatling script


4. A recorder window will be automatically displayed. This is the default:


gatling test easy


From here on you can customize and record scenarios.


Executing Your Gatling Scripts


1. Go to the bin folder (in this example C:\gatling-charts-highcharts-bundle-2.3.1\bin)


2. Double click on the “gatling.bat” file. This is the Gatling execution file, which runs the test.


execute gatling scripts


3. A command prompt window is displayed and then load testing information will be displayed on the command prompt window, such as: the GATLING_HOME variable, the Java execution file, Scripts, etc.


4. The Command prompt window will look like this:


gatling load test script


5. Choose the script file you want to execute from there.


Running Your Gatling Test in BlazeMeter

After creating your Gatling script in Scala, you can upload it to BlazeMeter and easily run your test in a SaaS product. Enjoy an easy to use GUI, advanced reporting and collaboration capabilities.


gatling in blazemeter


To try out BlazeMeter, put your URL in the box below and your test will start in minutes. Or, request a demo. So start testing now!

arrowPlease enter a URL with http(s)

Interested in writing for our Blog?Send us a pitch!