This page is about Gatling 1. About Gatling 2, see here.
In this quick start guide, you'll follow the minimal steps to have Gatling up and running in no time.
You can get Gatling bundles as a
.zip file here.
Gatling 1 is compiled with JDK6, while Gatling 2 is compiled with JDK7, yet into JDK6 bytecode. In any case, Gatling 1 can't be built with JDK7 as some Swing classes have been parameterized since.
The launch scripts set up JVM options that may only be available since latest JDK6 versions. If you use an old JDK6, please consider upgrading, or edit the scripts for removing the unsupported options. If you use an JDK < 6, you have to upgrade.
Yet, we recommend that you use the latest JDK7. NIO is based on native code, so it depends on JVM implementation and bugs are frequently fixed. For example, NIO have been broken on Oracle JDK7 until 1.7.0_10. Gatling is mostly tested on Oracle JDK7, OS X and Linux.
Just unzip the downloaded bundle to a folder of your choice.
X-platform users: don't use a path with spaces in it.
Windows users: we recommend that you do not put Gatling in Programs folder as there might be permission issues.
You might first want to have a look at how to tune Gatling and your OS according to your use case.
Gatling uses by default UTF-8. If you want to use a different one, you have to:
gatling.conffile. This is the one that will be used for compiling your simulations and building your requests.
Gatling offers a command line interface (CLI) that can be run using the following command:
Windows users: you can double click on the gatling.bat file located in GATLING_HOME/bin
Once executed, you should see a menu with the simulation examples:
Collecting simulations... Choose a simulation number:  advanced.AdvancedExampleSimulation  basic.BasicExampleSimulation
To run a simulation, simply type the number of the simulation you want to run, choose a name for the folder where the results will be generated, and a description for the run.
Note: If Gatling does not work as expected, see our FAQ.
Gatling can log requests and responses. See config file
This is how Gatling works, now you have to write your own simulations. We provide you with several resources to learn how to do it:
user-filesfolder will give you a sneak peek of what Gatling scripts look like
Last edited by Stephane Landelle,