TestProject Agent and Organization Security

If you are trying to use the TestProject Agent in a restricted environment, with various security policies in place, that are blocking the Agent components from getting started, you might encounter errors.

Installation on a restricted file system

If you are experiencing errors when trying to install the TestProject Agent, you might need to install it into a special provisioned folder, authorized to deploy and run vendor executables.

In some cases, a temporary administrative privilege might be required - if this is the case please contact your IT department and file a request for the necessary access. Note that running the Agent is always possible with a standard user (without special or administrative privileges).

Running and Recording tests in a restricted environment

Some organizations only allow running executables on their computers from a special folder.

TestProject Agent depends on other executables like the browser drivers. If your IT restrictions prevent a program to launch other executables, please check with your IT department what is filesystem location you can use to launch executables freely.

Assuming we use the location C:\sandbox as an example for an unrestricted location. Let's create a TestProject folder inside and start the TestProject Agent using the CLI (via command-prompt or terminal) with this custom data path:

testproject-agent start --data-path=C:\sandbox\TestProject -f

Manual Drivers Updating

In case your Agent is not registered and is not able to get registered, you might need to update the drivers manually.

Refer to the following guide on how this should be done: https://docs.testproject.io/testproject-agents/unregistered-offline-agent#manual-drivers-update

If you are still getting errors and blockage notification for Java or other processes, make sure to allow them and allow the drivers to get launched, otherwise you might see errors during your attempts to record or execute tests.


When your organization prevents communication outside of the internal network, and your attempts to register an Agent fail, you will need to contact your IT department and allow:

  • Communication with *.testproject.io

  • Make sure the user account that runs the TestProject Agent has permissions for binding to ports 8585 and 8443 on localhost/

If these ports are blocked for some reason you can change the default ports using the CLI as explained here: https://docs.testproject.io/testproject-agents/testproject-agent-cli in the Start command description, and the external connectivity section using the --rest-address option.

Besides the ability to change the default listening port using the technique above, it is also possible to allow external access to the Agent, specifically for communicating with it over the internal network using other interfaces such as the SDK.

Refer to this blog post for more information:


Did this answer your question?