Local testing with TestCloud in Katalon Studio

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

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

In Katalon Studio, you can use the Tunnel Setup Helper to download and configure TestCloud Tunnel.

Configure TestCloud Tunnel

Requirements

• TestCloud integration is enabled in Katalon Studio Enterprise (KSE), see: Enable TestCloud integration in Katalon Studio.
• TestCloud Tunnel Server hostnames are whitelisted. See: Common network issues and solutions.
• 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.

Follow these steps to set up TestCloud Tunnel with Tunnel Setup Helper.

1. In Katalon Studio, select the dropdown Run menu and choose to run with TestCloud.

2. In the TestCloud Configuration dialog, select your testing environment, then enable the Private/Local Testing option. You'll see a message, as follows:

   

3. Click the Tunnel Setup Helper link. The Tunnel Setup Helper dialog appears.

   

4. Follow the step-by-step instructions in the dialog to set up the tunnel client in your local machine:

   1. Select your OS and download the .zip file, then unzip it.
   2. Open the command-line interface (CLI) and navigate to the directory containing the tunnel executable file. Copy the command line from the dialog, then run it in the CLI.

   An example command looks like this:

   /Applications/kt config --tenant KatalonStudio --username "[myusername@katalon.com](mailto:myusername@katalon.com)" --organization-id "myid" --api-key "myapikey"

   note

   For users from EU region or other regions outside of US region: after step 2, you need to update the server URL in the tunnelconfig file before continuing with Step 3.

   3. Use the kt start command to start the tunnel.

      Note: Keep your CLI open until you have finished running tests.

   

5. Switch back to Tunnel Setup Helper and click Close.
   Click Refresh and you should see the message: "Tunnel is available".

   

6. Select Run to start executing your test suite / test suite collection with TestCloud Tunnel.

Update server URL

1. Open the folder where your terminal or command prompt is currently located.

   Example: If your terminal is opened at Desktop, open the Desktop folder.

2. In that folder, locate and open the tunnelconfig file using a text editor.

3. Update the server URL to match your region.
   EU region: https://tunnel-manager.eu.katalon.com

4. Save the changes to the tunnelconfig file.
5. Return to the Tunnel Setup Helper dialog and continue with Step 3.