Manager 9.0 Single Server Installation Guide for Windows


In this article, we provide step-by-step instructions to install qTest Manager 9.0 on a single Windows machine. Please read the instructions thoroughly before starting your installations.

To request assistance with installation or obtain the self-upgrade links, complete the OnPremise New Install Form.

Note: If you are not performing a fresh install and are upgrading, use the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Before You Begin

Read the following:

Install qTest Manager

  1. Request the installation files through the OnPremise New Install Form which is also available at the top of this article.

  2. Once the OnPremise New Install Form is completed and submitted, the download link will be emailed to you from our Implementation Team.

  3. Download and extract the zip file.

  4. Access the extracted directory (eg: C:\qtestmanager90\qtestctl)

  5. Open the file qtest.config.

  6. Modify the qtest.config files content as described below.

    • IMPORTANT: Replace the blue text in the brackets with your custom values. Only the information listed below in blue should be updated, all other data 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]'
        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]'
      /* common configurations */
      common {
        ssl {
          enabled = [Set it to true to enable a secure connection (HTTPS) between users’ browsers and the server]
         // key, cert, and pass are only affected if enabled is set to true
          cert = '[Location of your certificate file on this server. Please use \\ instead of \ in the path. It is mandatory if enable=true]'
          key = '[Location of your private key file on this server. Please use \\ instead of \ in the path. It is mandatory if enable=true]'
          pass = '[pass is mandatory if your ssl cert requires a passphrase, leave it empty otherwise]'
      /* 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 or https]://[qTest Manager server's IP or hostname]:[HTTP port as specified above]' 
         /* use https if SSL is enabled */
         /* server's IP or hostname must be accessible from outside of the server */
        ssl {
          port = [https port]
  7. Once you have completed modifying the file, Save.

  8. Open a Command Prompt as an Administrator and change the directory to C:\qtestmanager90\qtestctl

  9. Execute this command to initially set up the application.
    qtestctl.bat --offline start		


  10. The command will take control of the Command Prompt. Keep it running.

  11. Open your web browser, and access qTest Manager using the URL specified above in qtest.config to validate if it has started successfully.

  12. Navigate back to the Command Prompt and stop the running process (Ctrl + C).

Set Up Windows Service

Please follow instructions in this article to set up a Windows service for qTest.

Configure qTest Manager

Once qTest Manager is installed successfully, you can access it via your browser using the URL as specified in the 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.  

Next Steps:

Following this article to install qTest Sessions: Sessions 4.1 Single Server Install Guide for Windows


Powered by Zendesk