Launch 1.0 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.

In this article, we'll run you through installing qTest Launch 1.0 on a CentOS/ Ubuntu machine using Docker and then connect it to qTest Manager 9.0 on different machine.

Note: if you want to deploy qTest Launch 1.0 and qTest Manager 9.0 on the same machine using Docker, check out this article Manager 9.0 Single Server Installation Guide for Docker. 

Before you begin

  • Follow this article Getting Started with qTest OnPremise 9.0 - Spring 2018 to get an overview of qTest OnPremise deployment
  • Please make sure your server environment meets recommended hardware requirements
  • qTest Launch 1.0 only works with qTest Manager 9.0 or later
  • qTest Manager has been deployed using Docker on a separate machine
  • 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 

Installing qTest Launch 1.0

1. Download package

Download docker deployment package


Extract the package


Access to extracted package directory


2. Configure applications

 $ ./configure --apps "launch launchlb"

Configure URL and port

3.1 If you are going to deploy qTest Launch with HTTP

 $ ./configure --launch-url "http://<public IP of current machine>:<launch port>" --launch-http "<launch port>" --cluster "<IP of postgres docker server>" --qtest-url "http://<qtest manager's domain or public IP address>:<qtest port>"

3.2 If you are going to deploy qTest Launch with HTTPS

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --launch-url "https://<public IP of current machine>:<launch https port>" --launch-https "<launch https port>" --cluster "<IP of postgres docker server>" --qtest-url "https://<qtest manager's domain or public IP address>:<qtest https port>"

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.

Open your web browser, access to qTest Launch using the URL specified above in configure command to validate if it has started successfully


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

5. Configure qTest Manager

5.1 Login to qTest Manager using administrator account then access to Administration page.



Next, navigate to MISCELLANEOUS section then enter the URL of qTest Manager into qTest server's domain field. Note: if qTest Manager is not running on port 80, you have to specify the port number in the URL. 


5.3 Configure qTest Launch

In LAUNCH section, input the URL of your qTest Launch server

  • http://[qTest_Launch_IP_Address]:[HTTP_Port] if you installed qTest Launch without SSL certificate
  • Or https://[qTest_Launch_IP_Address]:[HTTPS_port] if you installed qTest Launch with SSL certificate.

Click Test Connection and wait for qTest Manager to show a message "Connected to server successfully" then click Save to save the configuration.

6. Access to qTest Launch

Follow these steps to validate that qTest Launch was installed and configured successfully.

From qTest Manager's top navigation, access to qTest Launch from nine box icon


You have finished installing qTest Launch on its own server.

Subscribe To Our Blog
Powered by Zendesk