# Katalon Studio

Last updated on : 07 Jul 2026



## Overview

Katalon Studio enables you to perform automated Mobile and Web Testing by creating codeless automation scripts and with a powerful record and playback feature. Integrating Katalon Studio with Pcloudy will help you run your existing scripts on 5000+ browsers and device combination.

### Prerequisites

* Pcloudy Account and the Pcloudy capabilities.
* Mobile Application must be uploaded to the section on Pcloudy portal.
* Katalon Studio configured on the user machine.

### 1. Record a Test Case on a Pcloudy Device in Katalon

#### Step 1: Configure Remote Settings in Katalon 

* Go to Project > Settings > Desired Capabilities > Remote
* Set the Remote server URL: https\://device.pcloudy.com/appiumcloud/wd/hub 

> **Note:**
>
> **Note:** To get the Remote Server URL, log in to Pcloudy, go to Capabilities under Mobile App Automation, select Appium, and copy the URL shown in the generated capabilities. 

* Set Remote server type to Appium
* Set Appium driver to Android Driver (use iOS Driver for iOS applications) 

#### Step 2: Add the Pcloudy Capabilities 

Unlike Web automation, Pcloudy's mobile capabilities are added as flat key-value rows directly in the capabilities table — no Dictionary type is required here. Click Add for each row and enter: 

| Name                    | Type | Value                              |
| --------------------------- | -------- | -------------------------------------- |
| pCloudy_Username           | String   | your Pcloudy account email             |
| pCloudy_ApiKey             | String   | your Pcloudy API key                   |
| pCloudy_DurationInMinutes  | Number   | 30.0                                   |
| newCommandTimeout           | String   | 600                                    |
| launchTimeout               | String   | 90000                                  |
| pCloudy_DeviceFullName     | String   | e.g. SAMSUNG_GalaxyM53_Android_15.0 |
| platformVersion             | String   | 15.0                                   |
| platformName                | String   | Android                                |
| automationName              | String   | uiautomator2                           |
| automationName              | String   | APIDemos.apk                           |
| appPackage                  | String   | io.appium.android.apis                 |
| appActivity                 | String   | io.appium.android.apis.ApiDemos        |

* Click Apply and Close![](https://www.pcloudy.com/docs/img/katalon-mobile/1.png)

#### Step 3: Select Katalon Recorder 

Katalon's Mobile Recorder can connect directly to a Remote Device session on Pcloudy, letting you capture objects and actions live on the device instead of writing test objects manually. 

* In the toolbar, click the dropdown arrow next to the mobile recorder icon
* From the menu, select Remote Devices

> **Note:**
>
> **Note:** This menu also lets you record against local Android Devices or iOS Devices — select Remote Devices specifically to record on a Pcloudy session.

![](https://www.pcloudy.com/docs/img/katalon-mobile/2.png)

#### Step 4: Configure the Recorder

* In the Mobile Recorder window, check the Configuration field — it should already show your Remote setup: 
  * Remote - https\://device.pcloudy.com/appiumcloud/wd/hub
* If it doesn't, click Edit to point it to the correct Remote configuration (the one set up in Project > Settings > Desired Capabilities > Remote)
* Leave Application Path/ID blank if the app capability (pCloudy_ApplicationName) is already defined in your Remote capabilities — Katalon will launch that app automatically
  ![](https://www.pcloudy.com/docs/img/katalon-mobile/3.png)

#### Step 5: Start Recording

* Click Start
* Katalon will launch the session on the Pcloudy device, and the live device screen will appear in the Device View panel on the right 

#### Capture Objects and Actions

* Click Capture Object, then click any element directly on the Device View screen (e.g., a menu item like "Accessibility Service")
* The captured element appears highlighted with a red box in Device View, and is added to the All Objects tree on the left, showing its full hierarchy path (e.g., android.widget.TextView - Accessibility Service)
* Use the Available Actions buttons (Tap, Tap And Hold, Get Text, Set Text, Swipe, Press Back, Press Home, etc.) to record an action against the captured object
* Each action you perform is added as a new row in Recorded Actions with its Object, Input, and Output
  ![](https://www.pcloudy.com/docs/img/katalon-mobile/4.png)

#### Save the Script

* Once all required steps are recorded, click Stop
* Click Save Script 
* Katalon converts the recorded actions into a test case, with each captured object automatically added to the Object Repository

### 2. How to Run Katalon Mobile Test Cases on Pcloudy

#### Step 1: Configure Remote Settings in Katalon 

* Go to Project > Settings > Desired Capabilities > Remote
* Set the Remote server URL: https\://device.pcloudy.com/appiumcloud/wd/hub

> **Note:**
>
> **Note:** To get the Remote Server URL, log in to Pcloudy, go to Capabilities under Mobile App Automation, select Appium, and copy the URL shown in the generated capabilities. 

* Set Remote server type to Appium
* Set Appium driver to Android Driver (use iOS Driver for iOS applications)

#### Step 2: Add the Pcloudy Capabilities

Unlike Web automation, Pcloudy's mobile capabilities are added as flat key-value rows directly in the capabilities table — no Dictionary type is required here. Click Add for each row and enter: 

| Name                    | Type | Value                              |
| --------------------------- | -------- | -------------------------------------- |
| pCloudy_Username           | String   | your Pcloudy account email             |
| pCloudy_ApiKey             | String   | your Pcloudy API key                   |
| pCloudy_DurationInMinutes  | Number   | 30.0                                   |
| newCommandTimeout           | String   | 600                                    |
| launchTimeout               | String   | 90000                                  |
| pCloudy_DeviceFullName     | String   | e.g. SAMSUNG_GalaxyM53_Android_15.0 |
| platformVersion             | String   | 15.0                                   |
| platformName                | String   | Android                                |
| automationName              | String   | uiautomator2                           |
| pCloudy_ApplicationName    | String   | APIDemos.apk                           |
| appPackage                  | String   | io.appium.android.apis                 |
| appActivity                 | String   | io.appium.android.apis.ApiDemos        |

* Click Apply and Close![](https://www.pcloudy.com/docs/img/katalon-mobile/5.png)

#### Step 3: Update the APK Name in Script Mode 

Before running, open your test case and switch to Script view. Update the `Mobile.startApplication()` line to reference the correct APK name uploaded to your Pcloudy account: 

`Mobile.startApplication('APIDemos.apk', false)`

Replace '`APIDemos.apk`' with the exact filename of your application as it appears under pCloudy_ApplicationName in your capabilities (Step 2) — this must match exactly, including case, or the session will fail to launch the app.
![](https://www.pcloudy.com/docs/img/katalon-mobile/6.png)

#### Step 4: Run the Test Case on Remote

* Open your test case
* Click the dropdown arrow next to the Run button in the toolbar
* From the list select Remote
* Katalon will use the Remote server URL and capabilities configured in Step 1–2
  ![](https://www.pcloudy.com/docs/img/katalon-mobile/7.png)

#### Step 5: Verify Execution

In Katalon's Log Viewer:

* Runs: 1/1, Passes: 1, Failures: 0
* Each step (startApplication, tap, getText, closeApplication) shows a green checkmark with its execution time 

In Pcloudy Dashboard (My Active Sessions):

* A session appears for the selected device (e.g. SAMSUNG_GalaxyM53_Android_15.0), Type: automation, Progress: On Going — confirming Pcloudy received and is running the session
* You can click the screen icon under Action to view the live session, or the link icon to get a shareable session link
* In Pcloudy Dashboard → Report, you would be able to view reports for your test case 

### Parallel Execution on Pcloudy

You can run multiple Test Suites concurrently on Pcloudy using a Test Suite Collection, with each suite requesting its own separate device session. 

#### Step 1: Set "Run with" to Remote for Each Suite

Open your Test Suite Collection and, for each row in the table, set the Run with column to Remote: 

All suites draw from the single shared Remote capabilities set up in Project Settings > Desired Capabilities > Remote (the device capabilities configured earlier). 

#### Step 2: Set Execution Mode to Parallel

In Execution Information at the top of the Test Suite Collection: 

* Execution Mode: select Parallel
* Max concurrent instances: set this to match your Pcloudy plan's concurrent device session limit
* Delay between instances (in seconds): optional stagger between launching each instance (e.g., 1 second) 

#### Step 3: Click Execute

![](https://www.pcloudy.com/docs/img/katalon-mobile/8.png)

Katalon will dispatch all suites to Pcloudy, running up to Max concurrent instances at the same time. 

#### Step 4: Verify Parallel Sessions on Pcloudy 

* In Pcloudy Dashboard → My Active Sessions, you should see multiple device sessions running simultaneously — one per suite currently executing, each showing Progress: On Going.
* In Pcloudy Dashboard → Report, you would be able to view reports for each individual test case run.
