Install and configure a Controller
The Controller is the hub of your performance testing setup. It decides how many virtual users to generate, directs the Load Generators, and tracks the results. Here’s how to set it up:
Configure the Controller agent
To connect the Controller to NeoLoad Web, you need to set up the Controller agent that connects NeoLoad to NeoLoad Web. To set it up follow these steps:
-
Launch the Controller agent:
-
Open the ControllerAgent.exe file from the NeoLoad bin folder.
-
Right-click the Agent icon in the system tray and select NeoLoad Web settings.
-
-
Set the deployment type:
-
Select SaaS for US-based SaaS deployments of NeoLoad Web.
-
Select On-premise for EU-based SaaS deployments of NeoLoad Web. You can retrieve the URL directly. Select API from the user menu in NeoLoad Web and copy the link without the /explore suffix. For example: https://neoload-api.saas.neotys.com/.
-
-
Authenticate with an access token:
-
Generate an access token in NeoLoad Web and paste it into the access token field (opens in new tab).
-
-
Set a zone (optional):
-
To assign the Controller to a zone, paste the Zone ID into the Zone identifier field (opens in new tab).
-
-
Test the connection:
-
Select Test to verify your settings. After a successful test, select Apply to save your changes.
-
Run the Controller agent as a service
When you run the Controller agent as a service ensures it starts automatically with your system.

-
Copy the controller_agent_user.properties file from your user directory to the system profile directory.
-
Use the Task Manager to set the service's Startup type to Automatic.

-
Edit the configuration files for SaaS or on-premise setups.
-
Create and enable a service using systemctl.