Package Configuration

Configure and upload your package to Gatling Enterprise Cloud.


To access the Packages section, click on Packages in the navigation bar. You need the Leader or Team Leader role to access this page.

The Packages view contains all the packages you have configured with the given name, team, filename of the uploaded package if not empty and the date of the last upload.

The Gatling version of the package is displayed in a badge next to the filename.

Packages table


In order to add a package, click on the “Create” button above the packages table.

Package creation
  • Name: the name that will appear on the simulations general step.
  • Team: select the team which will have access to the package.


Option 1: Manual Upload

In order to fill the package with your bundled simulation, click on the icon on the right side of the table.

Package upload empty

You can then drag and drop your package to fill the form and click on the Upload button.

Package upload filled

You can upload multiple packages concurrently. Uploads progress will be shown in the Packages table.

You can cancel an upload in progress by clicking on the cancel icon.

Package upload progress

Option 2: API Upload

You can also upload packages programmatically with our REST API.

You’ll need:

  • an API token with at least the Packages permission
  • the Package’s ID, which can be copied from the WebUI.

You can then upload your package, eg with curl:

curl -X PUT --upload-file <PACKAGE_LOCAL_PATH> \
  "https://<DOMAIN>/api/public/artifacts/<PACKAGE_ID>/content?filename=<PACKAGE_FILE_NAME>" \
  -H "Authorization:<API_TOKEN>"

Option 3: Plugin configuration

Maven, sbt and Gradle plugin offer commands to upload the generated package if properly configured. Check the Maven, Gradle, sbt plugin extensions for more information.


You can configure which package to use for a simulation in the simulation’s General step.

Package upload filled

Edit this page on GitHub