Getting Started with qTest OnPremise Summer 2018



This article is for the qTest 9.1.5 OnPremise release for Summer 2018. You will find information for Supported Operating Systems and Browsers, Prerequisite Applications, Installation/Upgrade Guides, Deployment Models, and Hardware Requirements and Supported Versions.

Release Notes

Below are the Release Notes for each qTest application associated with the 9.1.5 OnPremise release.

Hardware Requirements

Based on your team size and the applications included in your subscription plan determine the right hardware requirements before the installation. Please see this article: Server Sizing Guide

Deployment Models

qTest components (and prerequisites applications) communicate with each other via TCP and HTTP, so they can be installed on different systems, as long as they can connect via specific ports. Files that may need sharing among services can be supported by a distributed file system like NFS or SMB. In QASymphony's production cloud deployment, each application has a dedicated server to ensure the best control, but that may not be necessary for an OnPremise deployment. For best practices, please see the examples provided in this article: Selecting your OS and Deployment Model 9.1.5 and Later. 

Supported Systems

Operating Systems

qTest installation packages are available for these three types of environments:

  • Docker on Linux (CentOS 7.2-7.3) or (Ubuntu 16.04-16.10)  64-bit
  • Linux native (CentOS 7.2-7.3) or (Ubuntu 16.04-16.10)  64-bit
  • Windows native (2008 R2, 2012 R2, 2016)


qTest works best on the latest stable versions of:

  • Chrome
  • Firefox
  • Safari
  • IE11

Prerequisite Applications

Based on the OS environment, please see the list of prerequisites below:


  • Must have access to the outside internet (cannot be used in a closed network)
  • Docker Host v17.03-ce - v17.12-ce  See: Instructions to install Docker 
  • Kernel must be at least 3.10
  • Once you have Docker installed, you'll automatically have access to the prerequisite applications
  • If you're using CentOS, See: Adjust Docker Storage Drive for CentOS 

Windows or Linux (non-Docker)

The table below shows the required versions of prerequisite applications. These must be installed and running before deploying qTest applications.

Here are some basic instructions for installing these prerequisites. If you need more detailed instructions to install these prerequisites, click on the hyperlinks in the table below:

Prerequisite Apps Description Subscription Plan
    Sessions + Explorer Premium Elite

PostgreSQL  9.5.4 - 9.6.6


  • A PostgreSQL super user is required
  • This user must be named "postgres" and granted with read/write permissions
Database Server for Manager, Sessions, Insights and Launch check-icon-32x32.png check-icon-32x32.png check-icon-32x32.png
MongoDB  3.2 - 3.6 Database Server for Parameters, and Pulse   check-icon-32x32.png check-icon-32x32.png

An NFS directory


  • This is only required if you are deploying qTest applications using load balancing model
To store attachments (optional) (optional) (optional)

 IMPORTANT: RabbitMQ and Redis have been removed for the prerequisite list for 9.1.5 OP.

qTest Applications

Each application in the qTest platform delivers a tailored experience for its users. Below is a list of the applications that you should install for each subscription plan:

Product Description Subscription Plan
    Sessions + Explorer Premium Elite
Manager Test Case Management check-icon-32x32.png* check-icon-32x32.png check-icon-32x32.png
Sessions Screen Capture and Recording check-icon-32x32.png check-icon-32x32.png check-icon-32x32.png
Parameters Reusable Test Input Data   check-icon-32x32.png check-icon-32x32.png
Insights Testing Metrics and Analytics     check-icon-32x32.png
Launch Centralized Test Automation     check-icon-32x32.png
Scenario Enterprise BDD for Jira     check-icon-32x32.png
Pulse Agile and DevOps Workflows     check-icon-32x32.png

*qTest Manager component for Sessions + Explorer package is simply for Administration purposes and does not contain test case management features.

Install and Upgrade Guides

Below are links to our master Install and Upgrade Guides for the qTest Product Suite. These master guides provide you access to previous versions and operating system instructions.


Please note, that you must open the ports below prior to any self/assisted installation or upgrade. You should only open the HTTPS ports if you plan to serve SSL from the application.

Prerequisite Applications

Product  Port
Postgres 5432
Network Drive 2049
MongoDB 27017


Linux Docker  

Product HTTP Port HTTPS Port
Manager 80 443 
Sessions 8080 8443
qMap 7080 7443
Scenario 6080 6443
Insights 9080 9443
Parameters 10080 10443
Pulse 4080 4443
Launch 3080 3443


Linux non-Docker and Windows

Product HTTP Port HTTPS Port
Manager 8080 8443 
Sessions 9080 9443
Scenario 6080 4443
Insights 10080 10443
Parameters 5080 5080
Pulse 4080 4080
Launch 3080 3080

IMPORTANT: Suggested application ports are listed above. However, you are allowed to use a port of your choosing for the qTest applications you install.

Supported Versions

As outlined in our Terms of Use (Appendix A - Support Services), QASymphony OnPremise support expires for any software version more than 12 months after any superseding update. Therefore, we recommend that customers keep up with the latest updates and upgrade their software.

Below are the OnPremise software versions and their support status:

qTest Platform
Version Release Date Out of Support Date Status
9.1.5 June 2018 February 2019 Supported
9.0 February 2018 June 2019 Supported
8.7.3 October 2017 February 2019 Supported
8.4.4 June 2017 October 2018 Out of support
8.1.5 November 2016 June 2018 Out of support
7.7.3 June 2016 November 2017 Out of support
7.3.7 March 2016 June 2017 Out of support





Powered by Zendesk