Manager 9.0 Single Server Installation Guide for Linux (non-Docker)


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

To request assistance with installation or obtain the self-installation 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:

Important: qTest applications requires the username of 'postgres' to complete the installation. This 'postgres' user must also have Superuser rights.

Install qTest Manager

  1. Access your server and log in as root user on the command shell.
    $ sudo su
  2. Download the installation package provided to you by our Implementation Team.
  3. Extract the downloaded zip file.
    # tar qtestctl.tgz
  4. Access the extracted directory.
    Example: qtestctl
    # cd qtestctl/
  5. Open the qtest.config file and modify its 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]'
        logs = '[Enter a directory where logs are stored]'
        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]
  6. Save the file after modification is complete. 
  7. Execute this command to initially set up the application.
    # ./qtestctl --offline start		


  8. The command will take control of the Command Prompt. Keep it running.
  9. Open your web browser, and access qTest Manager using the URL specified above in the qtest.config file.
  10. Validate that qTest Manager has started successfully.
  11. Navigate back to the Command Prompt and stop the running process.

Set up Linux Daemon

Please follow the instructions in this article to install qtestctl as a Linux Daemon. 

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.

Next Steps

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

Powered by Zendesk