Learn about the Java and Scala requirements, install Gatling with the Bundle or build tool: maven, sbt, gradle


Java Version

Gatling supports 64bits OpenJDK 8 and OpenJDK 11 with HotSpot. Other JVMs such as JDK 12+, client JVMs, 32bits systems or OpenJ9 are not supported.

Scala Version

Gatling 3.5 requires Scala 2.13. Gatling 3.0 to 3.4 requires Scala 2.12.

Gatling Version

Make sure to use the latest version as documented on our website.

In particular, don’t use milestones (M versions) you could find on maven central, those are not documented and released only for internal use or Gatling Enterprise customers.

Using the Bundle

You can use Gatling as a standalone bundle. Then, you’ll just need a text editor, possibly with Scala syntactic coloration, to edit your simulations and you’ll be able to launch Gatling from the command line.

Check out our Open Source page for the download link.

Unzip the downloaded bundle to a folder of your choice. Use the scripts located in the bin directory for launching Gatling and the Recorder.

In order to run Gatling, you need to have a JDK installed. Gatling requires at least JDK8. Then, we recommend that you use an up-to-date version.

For all details regarding the installation and the tuning of the operating system (OS), please refer to the operations section.

Using a Build Tool


Gatling provides an official maven plugin named gatling-maven-plugin. This plugin lets you compile your Scala code and launch Gatling simulations.

Check the maven plugin documentation for more information.


Gatling provides an official sbt plugin named gatling-sbt. This plugin lets you launch your Gatling simulations.

Check the sbt plugin documentation for more information.


Gatling provides an official gradle plugin named io.gatling.gradle. This plugin lets you launch your Gatling simulations.

Check the gradle plugin documentation for more information.

Using an IDE

You can edit your Simulation classes with any text editor, maybe with some syntactic coloration for Scala. But if you are a developer, you’ll most likely want to use your favorite IDE with Gatling.

Gatling officially supports IntelliJ IDEA and eclipse.

IntelliJ IDEA

You’ll need to install the Scala plugin, which is available in the Community Edition. You’ll then be able to directly import regular maven or sbt projects with Scala sources out of the box.

You’ll most likely have to increase the stack size for the scala compiler so you don’t suffer from StackOverflowErrors. We recommend setting Xss to 100M.



You’ll have to install ScalaIDE, preferably the latest version, even a milestone.

Sadly, as of today, ScalaIDE is only available for Eclipse 4.7 (Oxygen) and is not compatible with more modern versions.

Note that Eclipse 4.7 doesn’t support Java 9+, so if you have multiple Java installations on your machine, you might have to force the JVM used in eclipse.ini, eg:


Moreover, if you’re using maven, you’ll need to install m2eclipse-scala to integrate ScalaIDE and m2e (the eclipse plugin for maven).

With sbt

If you’re using sbt, you can use sbteclipse to generate the eclipse project config.

With maven

If you’re using maven, you can use the scala-maven-plugin for compiling Scala code.

You’ll have to add the following section in your pom.xml:


Launching Gatling and the Recorder from the IDE

The gatling-highcharts-maven-archetype generates some helper classes that you can use to launch Gatling and the Recorder manually from your IDE. You can perfectly copy those 3 classes (Engine, Recorder and IDEPathHelper) in your own project.

Please check the launchers documentation section.

Edit this page on GitHub