Set up initial access to NeoLoad Web

Complete your initial setup to start testing with NeoLoad Web. This essential first step creates secure communication between your local NeoLoad tools and the NeoLoad Web platform, enabling you to run tests and analyze results from anywhere.

This setup involves generating an access token and configuring your NeoLoad desktop client. Once complete, you can immediately start running tests and sending results to NeoLoad Web for centralized analysis and team collaboration.

Before you start

Before you start, check the following:

Generate your access token

Access tokens authenticate your NeoLoad tools with NeoLoad Web. This token ensures secure communication and identifies your testing sessions.

To generate an access token, follow these steps:

  1. In the left navigation panel, select the Profile icon (looks like a person silhouette).
  2. You'll land on the Access tokens tab automatically.
  3. Select the GENERATE A NEW ACCESS TOKEN button.
  4. Enter a descriptive name for your token (for example, "My Desktop NeoLoad") and select GENERATE.
  5. Select the Copy to clipboard button next to your new token to copy it.

Note: Save this token securely - you won't be able to view it again after leaving this page.

Configure NeoLoad desktop automatically

The fastest way to connect your NeoLoad desktop client to NeoLoad Web is using the one-click auto-configuration feature. This automatically sets up your API connection, authentication, workspace selection, and lease options.

To configure NeoLoad desktop automatically, follow these steps:

  1. In NeoLoad Web, go to your Profile view and stay on the Access tokens tab.
  2. Find the access token you want to use and select Configure NeoLoad with this token in the same row.
  3. A new browser tab opens with configuration options.
  4. Choose your next step:
    • If NeoLoad isn't installed: Select Download NeoLoad to get the latest version
    • If NeoLoad is already installed: Select START NEOLOAD
  5. When prompted by your browser, allow it to open NeoLoad desktop application.
  6. NeoLoad opens and displays a success message confirming the connection is established.
  7. Choose your next action:
    • Select OK to start using NeoLoad immediately
    • Select Preferences to review and customize your NeoLoad Web settings

Verify your connection

Confirm everything is working correctly by checking your connection settings:

  1. In NeoLoad desktop, go to File > Preferences.
  2. Navigate to General Settings > NeoLoad Web.
  3. Verify that the URL, token, and workspace are populated correctly.

Troubleshooting

If you encounter issues during auto-configuration, try the following:

  • Make sure your browser allows the protocol handler for NeoLoad
  • Verify that NeoLoad 7.9 or later is installed
  • Check our detailed troubleshooting guide for specific solutions

What's next

With your setup complete, you can start testing immediately. Choose from the following options: