Manager 8.7.3 Single Server Installation Guide for Windows

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide, we will run you through step by step to install qTest Manager v8.7.3 on a single Windows machine. Please go through the guide below thoroughly before starting your installations.

Before you begin

Before you install qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Prerequisite applications must be installed and running prior to installing qTest Manager
    • PostgreSQL v9.5
    • Erlang
    • RabbitMQ v3.5.4
    • Redis v2.8.19

Install Prerequisite Softwares

Please follow these instructions to install prerequisite app(s) as mentioned above.

Create qTest Database in PostgreSQL server

This step is to create a database name which will be used when you configure qTest Manager (step #4 of the next section).

There are different ways to create a database in PostgreSQL. For Windows, you can use pgAdmin which is installed together with PostgreSQL server.

  1. Open pgAdmin
  2. Enter your username and password to connect to your PostgreSQL server
  3. On the left panel, right click on Databases folder and select New Database...
  4. Enter your database name and click OK
  5. Take note of the database name and use it in step #4 of the next section

Install qTest Manager

  1. Request the files through the form at the top of the page.
  2. Once the filled out. The download link will be sent.
  3. Download and extract the zip file.
  4. Access to the extracted directory (eg: C:\qtestctl)
  5. Open file qtest.config and modify its content as described below. Only information listed out here needs to be updated. Other information should remain unchanged
    // list of applications
    apps = ['manager']
    /* external tool configurations. these are used as shared configurations to construct applications below. */
    external {
      postgres {
        host = '[PostgreSQL server's IP or hostname]'
        port = [PostgreSQL server's port number]
        auth {
          user = '[PostgreSQL's username]'
          pass = '[PostgreSQL's password]'
        db {
          qtest = '[Enter a database name for qTest Manager as you created above]'
      redis {
        host = '[Redis server's IP or hostname]'
        port = [Redis server's port number]
      rabbitmq {
        host = '[RabbitMQ server's IP or hostname]'
        amqpport = [RabbitMQ server's AMQP port]
        stompport = [RabbitMQ server's STOMP port]
        vhost = '[The virtual hostname which will be used for qTest Manager]'
        auth {
          user = '[RabbitMQ server's username]'
          pass = '[RabbitMQ server's password]'
    /* application configurations */
    manager {
      port = [HTTP port which will be used for accessing qTest Manager through a web browser]
      data = "[Enter a directory where attachments are store. Please use \\ instead of \ in the path]"
      logs = "[Enter a directory where logs are stored. Please use \\ instead of \ in the path]"
      url = "http://[qTest Manager server's IP or hostname]:[HTTP port as specified above]"
  6. After you have done modifying the file, save it
  7. Open a Command Prompt as an Administrator and change directory to C:\qtestctl
  8. Execute this command to initially set up the application
    qtestctl.bat start		


  9. The command will take control of the Command Prompt. Keep it running. Open your web browser, access to qTest Manager using the URL specified above in qtest.config to validate if it has started successfully
  10. Go back to the Command Prompt and stop the running process
  11. Execute this command to set up qTest Manager as a Windows service


  12. Start the Windows service. You may need to wait for few minutes for qTest Manager to be available
    net start qtest	


Configure qTest Manager

After qTest Manager has been installed successfully, you can access it via your browser using the URL as specified in qtest.config file

You will need to configure your qTest Manager instance and import your licenses before it is ready for your users. Please follow this guide: Configure Manager.

Enable secure connection to qTest Manager

You will need to use any proxy tools (such as HAProxy, nginx) which are available in your organization to enable SSL for qTest Manager. In this document, we do not provide instructions to set up SSL using the proxy tool.

Powered by Zendesk