Upload a project

A project holds the test assets you design in NeoLoad, the desktop application: your user paths, populations, and scenarios. Upload it to NeoLoad Web to run it on shared infrastructure and keep every result in one place.

You must upload a project before you can configure anything else. Until you do, the Load scenario, Load zones, and Advanced sections stay locked.

In the NeoLoad project section, choose the method that matches where your project lives:

For a project open in NeoLoad, use NeoLoad export to web.
For a project saved on your machine, use File upload.
For a project in your team's Git repository, use Git clone.

NeoLoad Web accepts one file per project, up to 250 MB, in ZIP, YML, or YAML format. For information on how to handle YAML files, check out NeoLoad as-code (opens in new tab).

NeoLoad export to web

To use the NeoLoad export to web option, NeoLoad needs an access token that identifies your NeoLoad Web workspace. Generate an access token in NeoLoad Web, then paste it into the access token field (opens in new tab) in NeoLoad.

With the token in place, follow these steps:

Launch NeoLoad GUI and open the project you want to upload.
Go to Export project wizard and select Export and send to NeoLoad Web.
Select the right Workspace and Test, then select Next.

File upload

To upload a project that you saved on your machine, use the File upload option and follow these steps:

In the NeoLoad project section, select Select file.
Select the project file from your local storage. Alternatively, you can drag and drop the file.

Git clone

To upload a project to NeoLoad Web using the Git clone option, you must import the project from your Git repository. This option is ideal for teams using Git to manage project versions. To do so, follow these steps:

In the NeoLoad project section, select Clone from Git.
Enter the Git repository URL and select the branch you want to use.
Select Clone the project.

The system automatically validates the repository configuration when you save it. Only valid configurations can be saved.

If you use GitHub, enter your personal access token (PAT) in the password field. For more information, check out how to create a GitHub PAT (opens in new tab).

Upload a password-protected project

All NeoLoad projects can be password-protected (opens in new tab). You recognize a password-protected project by seeing a lock icon next to the file name after the upload.

In this case, simply enter the password after the upload by selecting Fill password in the upload section.

NeoLoad Web only validates the password when you start a test. If the password is incorrect, you can change it by selecting Edit password.

What's next

Now that you have successfully uploaded a project, it's time to select a scenario.