Using TestComplete on Virtual Machines

Applies to TestComplete 15.64, last modified on June 12, 2024

This page refers to key-based licenses — a legacy license type used in TestComplete until version 15.48. For information on the current, ID-based license type, see SmartBear ID-based Licenses.


You can create and run TestComplete tests on virtual computers. However, to use them, you need to configure the license server and license settings.

Possible issues

A TestComplete license is bound to the computer where you activated this license (to the computer’s MAC address, CPU ID, the virtual machine’s UUID). When you activate licenses on virtual machines, they are bound to the physical computers where these virtual machines are running. If you move the virtual machine to another physical computer, the hardware properties (like CPU ID) will change, the TestComplete License Manager will treat this situation as machine cloning and will block the product start.


The main idea is to have a license activated on a machine whose hardware properties don’t change. This means, for example, that you don’t move that virtual machine after activating a license on it.

Trial licenses

TestComplete trial licenses are Node-Locked licenses of a special type. They can be activated and used on virtual machines. That is, you can activate and evaluate a trial there. We recommend running that virtual machine on the same physical computer on which you activated the license.

Commercial licenses

Node-Locked licenses

Commercial Node-Locked licenses of TestComplete cannot be activated on cloud computers. You need to use a Floating User license. See below. Сontact the SmartBear Sales Team on upgrading your Node-Locked license to the Floating User one.

Floating User licenses
  1. Activate your Floating User license on some physical computer in your network.

  2. Install your TestComplete instances on virtual computers.

  3. Make sure that your virtual computers are connected to your local network and have access to the computer.

    If needed, configure licensing settings on TestComplete computers so they can access the remote License Manager. See Specifying License Manager for Connection for details.

Using the Floating User licenses, you will be able to --

  • Easily manage your licenses.

  • Create, configure, clone, and delete virtual machines with TestComplete installed without any limitations.

Using TestExecute licenses

If you need to run automated tests on virtual machines (not to create or debug them there), then a possible solution would be to use TestExecute. This is a resource-friendly utility for running TestComplete tests on computers, where TestComplete is not installed.

  • A TestExecute license is a Floating User license. You activate it on a physical computer. You can select the same computer where you activated your TestComplete license.

  • Install TestExecute on virtual machines.

  • Make sure that there is a functioning network connection between these virtual machines and the License Manager PC. Proxies and firewalls running in your network should allow connection to that PC. If needed, configure TestExecute licensing settings on the virtual machines to specify the License Manager for connection. See Specifying License Manager for Connection.

See Also

General Questions
TestComplete License Types

Highlight search results