Insights Single Server Installation Guide for Docker


In this article, we provide step-by-step instructions to install qTest Insights on a CentOS/ Ubuntu machine using Docker, and connect to qTest Manager 9.1.5 on another machine.

Note: If you want to deploy qTest Insights and qTest Manager 9.1.5 on the same machine using Docker, read Manager 9.1.5 Single Server Installation Guide for Docker.

To request installation assistance or to obtain the links to self-install, please click here to fill out the 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

  • qTest Insights only works with qTest Manager 9.1.5 or later
  • Docker 17.03 has been installed. Follow these instructions to install Docker on your machine
  • For CentOS, you need to follow additional instructions to adjust Docker Storage Driver from overlay to device mapper.
  • For CentOS 7.X+ or Ubuntu 16.10 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10

Read the following:

Install qTest Insights

1. Download the docker deployment package. 


2. Extract the package and access the directory.


3. Configure before deploying.

Access to the directory where you've extracted package, and run the ./configure command to deploy the package.

The command has to include URL & port of qTest Insights

  • If you want to deploy qTest Insights with HTTP, go to step 3.1, ignore 3.2
  • If you want to deploy qTest Insights with HTTPS, go to step 3.2

3.1 Configure to deploy HTTP 

$ ./configure  --insights-url "http://<IP of current machine>:<insights port>" --insights-http "<insights port>" --cluster "<IP address of qTest machine>"

3.2 Configure to deploy HTTPS  

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --insights-url "https://<IP of current machine>:<insights https port>" --insights-https "<insights https port>" --cluster "<IP address of qTest machine>"


4. Start the deployment process .

 $ ./startup

The script will download the application images to the Docker. It may take couple of hours depending on your network connection.

Once the installation is complete, access to qTest Manager via your browser and setup for qTest Insights.

Set up qTest Insights

Access your Administration page.


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

Scroll to the Insights section and enter the Insights 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