Prerequisites for installing the software

Before you can install the software you must complete certain tasks such as checking the system requirements, setting up licensing, and setting up the Docker environment.

Reviewing system requirements

Before you begin the installation, you must verify that your hardware and software meet the minimum requirements. You must have set up a system, which includes setting up the Docker, with the following minimum requirements:

  • 20 GB disk space
  • 16 GB RAM
  • Six CPUs
Note: For a complete list of system requirements, see the Software Product Compatibility Reports on the HCL License & Delivery Portal.

Setting up licensing

You do not require a separate license to use HCL OneTest™ Server, but you must have runtime licenses available to run tests from the server. You can use the existing entitlements of HCL OneTest Studio for API based tests and the required number of Virtual Tester packs for Performance and AFT tests by providing the URL to HCL License & Delivery Portal.

Before you install and use HCL OneTest Server, you must enable the license based on the type of product license that you have acquired. For details about HCL OneTest Studio licenses and how to enable licenses, see License descriptions.

You must have the following details before you start the installation process:

Setting up other software

On your computer, you must have installed and enabled the following software:
  • Git for Windows (only for Windows computer)
    For more information about downloading and installing Git for Windows, see Git for Windows.
    Note: You must install Git in the default location of the Windows operating system. For example, C:\Program Files. During the installation process, you must select the add to your PATH check box to install Git in the default location.
  • Hyper-V
  • JDK or JRE 1.8 or later

    For more information about downloading and installing JDK, see Java SE Development Kit 8. The JDK format might vary based on the operating system.

Complete the following prerequisite tasks as required:

Setting up and enabling the Docker environment

As a prerequisite to installing the software, you must set up and enable the Docker environment.


  1. Install Docker Desktop on Windows and Docker-CE and Docker-Compose on Linux. Follow the link and complete the steps there to install Docker depending on the OS:
  2. On Windows, after installing Docker on your machine, allocate 12 GB to Docker memory. To allocate Docker memory, perform the following:
    1. Right-click the Docker icon Docker_icon in the system tray.
    2. Click Settings > Advanced > Memory.
    3. Enter 12288 in the RAM text box and set 4 or more in the CPUs slide.
    4. Click OK.
  3. To verify if the Docker is up and running, open the terminal and enter the following command:
    $ docker run hello-world
  4. On Windows, after you have installed and set up Docker, you must share your drive to allow Docker to access the files on the host machine. To provide Docker access, perform the following:
    1. Right-click the Docker icon.
    2. Click Settings > Shared Drives.
    3. Select the drive and click Apply.