Skip to main content

Local testing with TestCloud in TestOps

This document shows you how to set up TestCloud Tunnel in TestOps and perform local testing.

If your application under test is locally hosted in a private network, you can set up a tunnel for TestCloud server to access the application. See: Local testing with TestCloud.

To perform local testing with TestCloud (on TestOps), you need to:
  1. Download and configure the TestCloud Tunnel.

  2. Run tests with the Private/Local Testing option enabled.

Configure TestCloud Tunnel

You need to download and activate the TestCloud Tunnel to start test executions for the local application.
  • To allow User Datagram Protocol (UDP) connections, the proxy must be configured.
  • If you use a Man-in-the-Middle (MITM) proxy, it must be configured to allow Transport Layer Security (TLS) connections.
  1. Go to Configurations > TestCloud Tunnels.
    The TestCloud Tunnels page appears.
  2. Switch to the Setup tab.
    You will see an on-screen step-by-step instruction on how to set up your TestCloud Tunnel.testcloud tunnel page
    Follow the on-screen instructions:
    1. Select your OS, download the binary file, and unzip the file.
    2. Right-click on the file to open it in the terminal (for macOS), or open the file in cmd.exe (for Windows).
    3. Copy the command in the Generate configuration section, and open a Terminal or Command Prompt to run the command.

      configure testcloud tunnel client

    4. Copy the command in the Start a tunnel section, and open a Terminal or Command Prompt to run the command.

      start tunnel client

    You have successfully configured the TestCloud Tunnel.
  3. To validate your TestCloud Tunnel configuration, go to the TestCloud Tunnels page and select the Tunnels tab.
    The TestCloud Tunnel should be in Active status as shown below.

    tunnel client is running

  4. Go to the Test Run List page and click on the Play icon to run your tests.
You have successfully configure a TestCloud Tunnel.

Run tests with the Private/Local Testing TestCloud Tunnel

Follow these steps to run local testing with TestCloud Tunnel.
  1. Sign in to Katalon TestOps and go to your Project.
  2. Go to Test Execution > Schedule Test Run.
    The Schedule Test Run dialog appears.
  3. In the Environment section, click on the drop-down menu and select More options.
    The dialog displays as below.

  4. Switch the Private/Local Testing toggle on.

    This toggle is also applied when you whitelist TestCloud IPs instead of using TestCloud Tunnel. See: Network configuration for TestCloud.

  5. Select the testing environment in the TestCloud section.
  6. Return to the Schedule Test Run dialog, then click Schedule / Run.
You have successfully run tests with TestCloud Tunnel enabled.