NeoLoad Web connection settings

The NeoLoad Web panel in Preferences lets you configure the connection between NeoLoad and NeoLoad Web. Once connected, you can send test results to NeoLoad Web, run tests at scale, and share results with your team from a web browser.

For a general introduction to NeoLoad Web, see Use NeoLoad Web.

Connect to NeoLoad Web

To connect NeoLoad to NeoLoad Web, you need an access token. Access tokens let NeoLoad authenticate with NeoLoad Web without using your password. You can create, copy, and delete tokens from your NeoLoad Web profile.

There are two ways to set up the connection:

Option A: Configure from NeoLoad Web

NeoLoad Web can push the configuration directly to NeoLoad. To set up the connection from NeoLoad Web, follow these steps:

1. In NeoLoad Web, go to User menu > Profile > Access tokens.

2. Select the configure NeoLoad icon next to the token you want to use.

3. Select Open NeoLoadGUI in the pop-up window. NeoLoad opens with the token and connection settings pre-filled.

4. In NeoLoad, select Apply to save the configuration.

Option B: Configure manually in NeoLoad

To configure the connection manually, follow these steps:

1. In NeoLoad, go to Edit > Preferences.

2. Select the NeoLoad Web panel.

3. In the Deployment section, select your deployment type:

   • SaaS: NeoLoad Web is hosted by Tricentis. No additional URL configuration is required.

   • On-premise: NeoLoad Web runs on your own infrastructure. Enter the URL that your NeoLoad controller uses to connect. The default format is http://nlweb.<your-company>.com:8080. Contact your NeoLoad Web administrator if you don't know the URL.

4. In the Authentication section, paste your access token in the Access token field. To generate a token, go to User menu > Profile > Access tokens in NeoLoad Web and select + Generate token. For details, see Manage access tokens in the NeoLoad Web documentation.

5. Select Test in the Check connection section to verify that the connection works.

6. Select Apply to save the configuration.

Proxy settings

If your network requires a proxy to reach NeoLoad Web, configure it in the Proxy section. You can select an HTTP or HTTPS proxy for the connection. For more information, see Proxy.

Activate data transfer

The Activate data transfer check box controls whether NeoLoad automatically sends test data to NeoLoad Web. This option is enabled by default.

When enabled, every test result is sent to NeoLoad Web automatically. You can still choose on a test-by-test basis whether to send results when you start a test.

Command line configuration

You can override the Preferences settings by using command line arguments. The -nlwebToken argument overrides both the access token and the data transfer activation setting configured in the UI.

This is useful for CI/CD pipelines or automated test environments where you manage the connection programmatically.

Subscription information

The Subscription section displays your license consumption:

• On-premise deployments: Displays N/A.

• SaaS deployments: Displays license usage for your account, split into two categories:

  • Current month tests: The percentage of test hours used in the current month. This counter resets on the first of every month.

  • Saved tests: The percentage of test hours used by all saved test results (excluding deleted results).

The gauge turns orange at 80% consumption and red at 90%. For details on managing your license and subscription, see Manage license and Check subscription details in the NeoLoad Web documentation.

What's next

Now that NeoLoad is connected to NeoLoad Web, here's what you can do:

• Create a test in NeoLoad Web by uploading a project and configuring a scenario.

• Run your tests at scale using cloud, static, or dynamic zones.

• Create dashboards to visualize performance data and share insights with your team.

• Manage access tokens to control which tools can connect to your NeoLoad Web account.

For the complete NeoLoad Web documentation, see the NeoLoad Web documentation.