Running Cross-Platform Web Tests in Parallel by Using Jenkins

Applies to TestExecute 14.72, last modified on January 12, 2021


Jenkins is a build management application that allows you to automate repetitive tasks like getting source code from a source code control, building projects, running automated tests, and so on.

You can include your cross-platform web tests into your workflow managed and automated with Jenkins in several ways:

The most convenient way is using the TestComplete support plugin, so we will describe it in detail in this section.


  • Jenkins version 2.121.1 or later.

  • The TestComplete Support plugin must be installed in Jenkins. For the instructions, see below.

  • A Jenkins node that you will use as a test workstation. The node must meet the following requirements:

  • Your TestComplete project must be prepared for running cross-platform web tests.

    If you use CrossBrowserTesting as your device cloud provider, your TestComplete project must be able to access your account. To learn more, see the Cross-Platform Web Tests in the TestComplete documentation.

Install TestComplete Support plugin

Online installation

  1. In Jenkins, go to Manage Jenkins > Manage Plugins.

  2. Switch to the Available tab.

  3. Find TestComplete support plugin and click Install without restart.

    Tip: Press Ctrl+F and search through the page for TestComplete keyword to find the plugin faster.

Offline installation

  1. Download a TestComplete Support Plugin .hpi file from

  2. In Jenkins, go to Manage Jenkins > Manage Plugins.

  3. Switch to the Advanced tab.

  4. Click Choose File in the Upload Plugin section.

  5. Select the plugin file on your device.

  6. Click Upload.

How it works

Cross-platform web tests you create with TestComplete can run in device clouds managed with Selenium Grid. It can be:

  • SmartBear device cloud solution —

  • A private hub with Selenium Grid configured on your local computer or on a remote computer in your network. To learn more about installing and configuring Selenium Grid, see

Selenium Grid allows distributing tests among devices (Selenium nodes); it is a common task to run your tests in parallel, with each test running on a separate device.

To run your cross-platform web tests in parallel, you use a test runner tool that allows several instances of it to run on the same workstation. To control the tool from your Jenkins pipeline, use the TestComplete Test step provided by the TestComplete Support plugin:

Running cross-platform web tests from Jenkins

Click the image to enlarge it.

Where to go next

To learn how to configure a pipeline to run several cross-platform web tests in parallel:

Configuring Jenkins Pipelines to Run Cross-Platform Web Tests in Parallel

For information on the Pipeline syntax of the TestComplete Test step:

TestComplete Test Step Pipeline Syntax for Parallel Test Runs

See Also

Managing Parallel Test Runs

Highlight search results