6.2.4 Installing & Configuring Automation Host on Mac


  • Java version 1.7+ has been installed on your machine.

After the zip file (qtest-automation-x.x.x-release-osz.zip) has been downloaded, place it in a directory on your machine. Extract it and you will find the installation file.


By default, the tool will use domain localhost and port 6789 when it is running. However, you can change the default values:

  • Right click on the installation file and choose Show Package contents.


  • Open and modify file Info.plist.


  • Input your desired values and close it.


Double click on the installation file. The tool will be starting up. You can find its icon at the bottom bar.


After it has started up, it will open your browser. For the very first time, you will need to input the following information.

  • Host Name: the displayed name of this host in your qTest application. For now, you will not be able to modify this field after registering.
  • qTest URL: the URL to access to your qTest application.
  • Full Name: the displayed name of your qTest account.
  • qTest username and Password: the credentials to login to your qTest application.
  • If a proxy server is being used, click on Configure Proxy and then enter its info so the agent is able to submit test results to your qTest instance
    • Enable: select it in case a proxy is used
    • Host (required): host name or IP address of the proxy server
    • Port (required): port number of the proxy server
    • Username and Password: you can specify the domain before your username

After you have done filling in the information, click on Register button to register the host in your qTest.



  • It is strongly recommended that the account is granted with Create Test Cases and Execute Test Runs permissions.

On the next screen, you can see the status indicates that the Automation Host has been registered successfully. You can also modify the followings:

  1. Polling frequency: select how often your automation agents will poll qTest for new automation schedules.
  2. Automation frameworks: there is a plugin for each supported framework. You can freely download the framework your project is working on from the list by clicking on the Download icon.
  3. Automation Agents: you can create new agents or edit existing ones' configurations.

Click on Save button to save the host's configurations.

To verify if the host has been registered successfully in qTest:

  • Login to your qTest application and access to any projects in which Automation Integration feature is activated.
  • Click on Automation Settings and choose tab Schedules.
  • You will see the list of registered Automation Host in the left panel.


  • It is required that your qTest account is granted with Manage Project Settings permission to view registered host and agents' schedules in qTest.