Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Gatling: Step by step guide to IntelliJ integration

Step by step guide to setting up IDEA to write gatling simulations


Have SBT plugin installed


create project

add archetype

  • Select the newly create archetype and click next
  • Click Finish button to complete project creation

If all goes well, the project will be set up and ready to use

Recorder.scala - run this to launch the gatling recorder to record simulations

Engine.scala - run this to execute existing simulations


Gatling IDE integration


When creating the archetype, even though IDEA says the repository is optional, it is important you specify the one for the gatling archetype. This is because gatling archetype is not hosted on maven central and if you fail to provide the URL (, you will end up with error like

(701 B at 2.7 KB/sec) 
[INFO] Building Maven Stub Project (No POM) 1 
[INFO] >>> maven-archetype-plugin:2.2:generate (default-cli) @ 
standalone-pom >>> 
[INFO] <<< maven-archetype-plugin:2.2:generate (default-cli) @ 
standalone-pom <<< 
[INFO] --- maven-archetype-plugin:2.2:generate (default-cli) @ 
standalone-pom --- 
[INFO] Generating project in Batch mode 
[INFO] Archetype defined by properties 
[ERROR] Failed to execute goal 
(default-cli) on project standalone-pom: The desired archetype does 
not exist 
-> [Help 1] 
[ERROR] To see the full stack trace of the errors, re-run Maven with 
the -e switch. 
[ERROR] Re-run Maven using the -X switch to enable full debug logging. 
[ERROR] For more information about the errors and possible solutions, 
please read the following articles: 
[ERROR] [Help 1] 

For command line lovers

You can also generate the archetype from the command line directly using

mvn archetype:generate \

and then import it as a maven module from within IntelliJ. A longer way to archieve the same thing :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.