---
title: Run tests in the cloud with Ranorex and TestingBot
description: A how-to on running WebDriver tests from Ranorex Studio on TestingBot's
  remote browser cloud.
source_url:
  html: https://testingbot.com/support/integrations/ranorex
  md: https://testingbot.com/support/integrations/ranorex/index.md
---
# Integrate TestingBot with Ranorex

Ranorex is a GUI test framework, designed to execute tests. Using Ranorex Studio, you can easily manage and record tests, in your local browser. Without writing any code, you can create advanced Selenium WebDriver test cases.

This guide will help you in setting up a connection between Ranorex Studio and TestingBot, allowing you to run tests created with Ranorex on TestingBot's remote browser grid.

## Getting started with Ranorex

1. Start Ranorex Studio and click the **Web** tab in the wizard to create a new Web test.

2. Provide the Solution name and Directory Location to store this new Project, then click **Continue**.

3. Specify the URL of the website you'd like to test and choose a browser in the next screen. Next, click **Continue**.

4. Select **Do not use whitelisting** as recording behavior.

5. Select **Finish** to complete this solution.

## Setting up TestingBot Endpoint in Ranorex Studio

Before you can run a Ranorex Studio test on TestingBot, we'll first have to set up TestingBot as an endpoint. To do this, please follow the steps below.

1. To run the test on TestingBot's remote browser grid, add the TestingBot endpoint by selecting **View** in the menubar, then click **Endpoints**. Or type `Ctrl+Alt+P`.

2. In the dialog that appears, click the **Add endpoint** button.

3. Select **WebDriver** as the Endpoint type. As the Endpoint name, you can fill in TestingBot. The address should be `https://hub.testingbot.com/wd/hub`. Finally, click the **Add endpoint** button.

4. You have now successfully added TestingBot as an Endpoint. Click the icon next to TestingBot's endpoint to activate it (making it green).

## Executing Ranorex tests on TestingBot

1. You will need to add the necessary capabilities to the Endpoint's **Capabilities JSON** section. To do this, right click the TestingBot connector and click **View details**.

2. Add the following capabilities in **Capabilities JSON section** and add a name in the Name field. Finally, click the **Save** button.

3. Now mark the configuration you just created as the **Active configuration**.

4. Before we can run tests, we will need to increase the default timeout value of 10 seconds. To do this, open the settings by clicking the **Open Settings** button.

5. With the Settings window open, click the **Plugins** tab and scroll to the **WebDriver** section, where you will see a **WebDriver command timeout** value of 10.

6. To run a test, make sure you've selected the TestingBot endpoint.

7. You can now run your Ranorex test on TestingBot.  
Click the **Run** button. Once the test has finished, you will see it appear in the TestingBot dashboard with a video, logs and other metadata.

## Testing privately hosted websites with Ranorex and TestingBot

TestingBot allows you to run automated tests on internal development environments such as staging URLs or localhost.

To get started, please make sure you've downloaded [TestingBot Tunnel](https://testingbot.com/support/tunnel). You can start the tunnel through the commandline:

    java -jar testingbot-tunnel.jar key secret --tunnel-identifier ranorexTunnel

Next, you will need to edit the **Capabilities JSON** configuration in the custom TestingBot endpoint you've created and add a `tunnelIdentifier` in the `tb:options` JSON object.

    {
      "tb:options": {
        "key": "....",
        "secret": "...",
        "tunnelIdentifier": "ranorexTunnel"
      }
    }

## Passing custom capabilities with Ranorex Studio

TestingBot provides various [custom capabilities](https://testingbot.com/support/web-automate/selenium/test-options) to configure test runs, such as changing the `browserName`, `browserVersion`, `platformName` and more.

To include these with your test, make sure to edit the **Capabilities JSON** configuration in the custom TestingBot endpoint you've created.

    {
      "browserName": "chrome",
      "browserVersion": "latest",
      "platformName": "WIN11",
      "tb:options": {
        "key": "....",
        "secret": "...",
        "screen-resolution": "1280x1024",
        "name": "Ranorex Test"
      }
    }

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

[Email us](https://testingbot.com/contact/new)[Slack Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)