Sessions 4.2.7 Single Server Installation Guide for Docker


In this article, we provide instructions for installing qTest Sessions 4.2.7 on a CentOS/ Ubuntu machine using Docker, as well as how to connect it to qTest Manager 9.7.1 on a different machine.

If you want to deploy qTest Sessions 4.2.7 and qTest Manager 9.7.1 on the same machine using Docker, read this article Manager 9.7 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 On-Premise 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 Manager 9.7.1 is deployed and running in a separate machine.
  • qTest Sessions 4.2.7 only works with qTest Manager 9.7 or later.
  • For CentOS, you need to follow additional instructions to adjust Docker Storage Driver from overlay to device mapper.
  • For CentOS 7.X+ or Ubuntu 18.04 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10.

Read the following:

Download Docker-Deployment 4.9 Package


Extract the Package


Access the Extracted Package Directory


Configure the Applications

$ ./configure --apps "sessions sessionslb"

Configure to Deploy HTTP

If you are going to deploy qTest Sessions with HTTP.

$ ./configure --sessions-url "http://<Public IP address of current machine>:<sessions port>" --sessions-http "<sessions port>" --cluster "<IP of postgres docker server>"

Configure to Deploy HTTPS

If you are going to deploy qTest Sessions with HTTPS.

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --sessions-url "https://<Public IP of current machine>:<sessions https port>" --sessions-https "<sessions https port>" --cluster "<IP of postgres docker server>"


Start the Deployment Process 

 $ ./startup

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

Once the installation is complete, access qTest Manager via your browser and start to configure qTest Manager and qTest Sessions.

Set up qTest Applications

Please follow this guide: Configure qTest Applications to complete the remaining steps to activate your account.

Powered by Zendesk