Insights 1.12.2 Single Server Installation Guide for Linux (non-Docker)

To request installation assistance or to obtain the links to self-install, please click here to fill out the New Install Form.

In this guide we'll run you through installing qTest Insights 1.12.2 on a CentOS/Ubuntu Machine

Before you begin

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

  • Your machine needs to satisfy qTest's recommended hardware requirements
  • qTest Manager 8.7.3 has been deployed 
  • qTest Sessions 4.0.2 has been deployed
  • Access to the server where you install qTest Manager's Database, connect to your Manager database and create a schema for Insights.
 $ \connect [qTest_database] 
$ CREATE SCHEMA insights;
  •  Make sure postgresql5-contrib be installed in the server where you've installed qTest Database.
 sudo apt-get install postgresql95-server postgresql95-contrib 

Install qTest Insights 1.12.2

1. Execute following command to update and upgrade system packages

 # apt-get update -y && apt-get upgrade -y 

2. Download qTest Insights package


3. Extract the package  

 $ tar -zxf qtestctl-3.5.2-linux-x64-full.tgz 

4. Access to the package 

 cd qtestctl/ 

5. Modify the configure file 

 vim qtest.config 


Open the file \qtestctl\qtest.config , modify following section only

apps = [‘insights’]
/* external tool configurations. these are used as shared configurations to construct applications below */
external {
postgres {
  host = '<IP address of Postgres server>'
  port = <Postgres port>
    auth {
user = ‘postgres’ 
    pass = '<password of postgres user>'
    db {
    qtest = '<qTest Manager database>'
    session = '<Sessions database>'
/* application configurations */
Insights {
//Insights HTTP Port, make sure the port is not being used by other application
  httpport = <qTest Insights port>
//Insights Admin Port, make sure the port is not being used by other application
  adminport = <qTest Insights admin port>
scheduler {
//Scheduler host (same machine with Insights)
server = '<qTest Insights server>'


6. Install & Start

Open the console on your machine (run as Administrator role), change the current path to qtestctl directory and follow steps:

6.1 Execute this command to initially set up the application

 $ ./qtestctl --offline start

Once you see this message, qTest Insights has been started.


6.2 The command will take control of the Command Prompt. Keep it running. Open your web browser, access to qTest Insights using its URL http://<Insights_host>:<Insights_http_port> to validate if it has started successfully.

HINT: Open http://<Insights_host>:<Insights_http_port>, if you get the message "Access denied. Please login again through qTest", that means Insights has started successfully.


6.3 Go back to the Command Prompt and stop the running process (CTRL + C to terminate)

6.4 Execute this command to run qTest Manager as a OS service

 $ ./install

6.5 Start the OS service

 $ systemctl start qtest

To check if the service is up, use command

 $ systemctl status qtest


That's everything and you now have qTest Insights being installed and started.


Now, you need to connect it to your qTest Manager, access to your qTest Insights and follow steps in the section "Set up qTest Insights"

Set up qTest Insights

Access your Administration page


Under System Configuration page, scroll to section MISCELLANEOUS and enter qTest URL into the field qTest server's Domain.

Scroll to Insights section and enter Parameters URL

http://<IP of the machine where you installed qTest Insights>:<Insights port which you've specified in the config file>

Test Connection and save the configuration.




That's it! You now can access qTest Insights via its option in 9box icon



In order for the Insights Scheduler (it is to send scheduled report to your email) to work properly, make sure that you do configure your Email Server in qTest Manager's System Configuration page.



Powered by Zendesk