Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gatling/gatling.io-doc/llms.txt

Use this file to discover all available pages before exploring further.

Dedicated IP addresses are static IPv4 addresses provisioned in specific regions for your Gatling Enterprise organization. Once provisioned, these addresses can be assigned to your test runs so that all load generation traffic originates from a consistent, known set of IPs. This is particularly valuable when the application under test sits behind a firewall that restricts inbound connections by IP address, or when your security policy requires all external load test traffic to be explicitly whitelisted before a test can reach a production-like environment.
Dedicated IP addresses are only available on Gatling Enterprise paid plans. To request provisioning, open a ticket with technical support.

​
How dedicated IPs work

During a test run that uses dedicated IPs, Gatling Enterprise automatically allocates one of your unused dedicated IPs to each load generator, provided the IP matches both the configured location and current availability. The IP remains reserved for the duration of the run and is released afterward. If there are not enough available dedicated IPs to cover all configured load generators at run start, the run will not start. Gatling Enterprise checks availability before provisioning any load generators.
Dedicated IPs are only available for managed locations. They cannot be combined with private locations in the same test.

​
Requesting dedicated IPs

Contact technical support to provision dedicated IPs for your organization. Include the following information in your request:
FieldDescription
Organization slugFound in Organization Settings
Desired IPs per locationNumber of IPs needed and the target region(s)
Contact emailPrimary point of contact for the provisioning process
GitHub usernameFor account linking purposes
A Gatling sales representative will follow up to complete provisioning.

​
Viewing your dedicated IPs

Navigate to Dedicated IP Addresses in the Gatling Enterprise navigation bar to view your provisioned IPs. The table lists each IP address and its associated location region.

​
Enabling dedicated IPs on a test

​
From the UI

When creating or editing a test, in the Locations step, enable the Use Dedicated IPs toggle. Gatling Enterprise will then automatically assign available dedicated IPs in the configured regions when the run starts.
1

Open the test configuration

Navigate to the Tests view and either create a new test or edit an existing one.
2

Go to the Locations step

Select your managed location(s) in the locations step.
3

Enable dedicated IPs

Activate the Use Dedicated IPs option. This instructs Gatling Enterprise to reserve your static IPs for every run of this test.
4

Save the test

Click Save or Save and Launch. On each run start, Gatling Enterprise will verify IP availability before provisioning load generators.

​
Via configuration-as-code

Set the useDedicatedIps property to true in your test configuration file: 
gatling.enterprise {
  simulation = "com.example.MySimulation"

  useDedicatedIps = true

  locations = [
    {
      id = "us-east-1"
      size = 2
    }
  ]
}

​
Whitelisting dedicated IPs

Once your IPs are provisioned, share them with your network or security team for whitelisting in firewalls, WAFs, API gateways, or any other access control layer that restricts inbound connections by source IP.
Retrieve your dedicated IP list from Dedicated IP Addresses in the UI, or query them programmatically via the Gatling Enterprise Public API.

​
Availability and run start behaviour

ScenarioOutcome
Enough IPs available for all load generatorsIPs are reserved; run starts normally
Insufficient IPs for the configured load generatorsRun is blocked; an error message is displayed
Another run is using some of your IPsThose IPs are unavailable until the other run completes
Plan your concurrent test runs carefully. If multiple tests are configured to use dedicated IPs in the same region simultaneously, they compete for the same pool. Provision enough IPs to cover your peak concurrent demand.

Build docs developers (and LLMs) love

Get started for freeTalk to us