About Running Tests via Remote Desktop

Applies to TestLeft 15.40, last modified on March 17, 2022

Remote Desktop is a built-in Windows feature you can use to access a Windows session running on a computer from another computer. To do this, the computer must have special server-side software installed. It can be software included in the operating system, or it can be third-party software (for example, VNC, DameWare, or NetOP).

To run automated tests via Remote Desktop, you install TestLeft on a remote computer, and then use Remote Desktop to connect to the computer and start testing.

Why Use Remote Desktop

You can use Remote Desktop if you need, for example, to:

  • Run tests on remote computers and observe the tested application’s behavior on remote computers.

  • Run tests on computers that are locked by security reasons.

To Run Tests on Remote Desktop

  1. Make sure the remote computer where you will run tests has TestLeft installed.

  2. If needed, lock the computer where you will run tests.

  3. Log in to the TestLeft workstation via Remote Desktop from your local computer.

  4. Start running TestLeft tests. You can run them directly on the remote computer or you can start them remotely from your local computer.

Important Notes

When running GUI tests via Remote Desktop, do not perform the following actions:

This way, you will keep the operating system in GUI mode so that the test engine could interact with the GUI of the tested application.

Note: These restrictions do not apply to tests that do not involve interactions with GUI.


If your remote computer is running under a server version of the Windows operating system, you can open several user sessions on it. However, the number of TestComplete/TestExecute/TestLeft instances running concurrently depends on your license.

If you have a Node-Locked license, only one instance can run on the computer at a time. That is, you can run tests in one user session only.

If you have a Floating User license, your license key determines the number of instances that can run concurrently. The number of user sessions in which you run tests cannot exceed the limit set by the license.

If you want to run tests in several user sessions connected to the same server, we recommend that you use the TestLeft test runner as it is always installed with a Floating User license.

See Also

Running TestLeft Tests via Remote Desktop
Using TestLeft

Highlight search results