# Parallel Execution on Pcloudy

Last updated on 08 Jul 2026



## Overview

Katalon Studio enables you to perform automated web testing by creating codeless automation scripts with a powerful record-and-playback feature. Integrating Katalon Studio with Pcloudy allows you to run your existing scripts on 5000+ browser and device combinations. This guide explains how to configure Katalon Studio Web UI test cases to run remotely on Pcloudy's Browser Cloud.

## Prerequisites

* Pcloudy account with valid credentials.
* Web application uploaded to the Pcloudy portal.
* Katalon Studio installed and configured on your local machine.

## Step 1: Configure Remote Settings in Katalon

1. Go to Project > Settings > Desired Capabilities > Remote.
2. Set the Remote Server URL.

> **Info:**
>
> **Note:** To get the Remote Server URL, log in to Pcloudy, navigate to Capabilities > Web Automation > Selenium, and copy the generated Remote Server URL.
>
> Example:
>
> `https://browser.device.pcloudy.com/seleniumcloud/wd/hub`

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

1. Set Remote Server Type to Selenium.

## Step 2: Add the Pcloudy Capabilities (as a Dictionary)

The capabilities table only supports flat key-value pairs by default — but it has a hidden Dictionary type that lets you nest values, which is required for Pcloudy's `pcloudy:options` structure.

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

1. Click Add to create a new row.
2. Set Name = `pcloudy:options`.
3. Click the Type column for that row, and from the dropdown select Dictionary (other options shown - String, Boolean, Dictionary, List, Number)
4. Click into the Value cell - a small button appears ([...]) that opens the Dictionary Property Builder.

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

1. In the Dictionary Property Builder, click Add for each property and enter -

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

| Name           | Type   | Value                   |
| -------------- | ------ | ----------------------- |
| userName       | String | Your Pcloudy Email      |
| accessKey      | String | Your Pcloudy Access Key |
| os             | String | Windows                 |
| osVersion      | String | 10                      |
| browserVersion | String | 138                     |
| browserName    | String | Chrome                  |

1. Click OK to close the Dictionary Property Builder.

## Step 3: Add browserName as a Separate Top-Level Row

Add one more row alongside `pcloudy:options`.

| Name        | Type   | Value  |
| ----------- | ------ | ------ |
| browserName | String | chrome |

Your final Remote Capabilities table should look like -

| Name              | Type       | Value                                                                                             |
| ----------------- | ---------- | ------------------------------------------------------------------------------------------------- |
| `pcloudy:options` | Dictionary | `{userName=..., accessKey=..., os=Windows, osVersion=10, browserVersion=138, browserName=Chrome}` |
| browserName       | String     | chrome                                                                                            |

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

1. Click Apply and Close.

## Step 4: Run the Test Case on Remote

1. Open your test case.
2. Click the dropdown arrow next to the Run button in the toolbar.
3. From the list select Remote.

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

1. Katalon will use the Remote server URL and capabilities configured in steps 1-3.

## Step 5: Verify Execution

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

### In Katalon's Log Viewer

* Runs: 1/1, Passes: 1, Failures: 0
* Each step (`openBrowser("")`, `navigateToUrl(...)`, `closeBrowser()`) shows a green checkmark with its execution time.

### In the Job Progress Panel

* Entry shows: `Test Cases/Pcloudy_Browser_TC01 - Remote - https://browser.device.pcloudy.com/seleniumcloud/wd/hub` with a green Passed status.

### In Pcloudy Dashboard (My Active Sessions)

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

* A browser session appears (for example, Windows_10_chrome_138). Type:automation, Progress: On Going - confirming Pcloudy recieved 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 testcase

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

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

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

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 `pcloudy:options` Dictionary configured earlier).

Project > Settings > Desired Capabilities > Remote

## 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 session limit
* Delay between Instances (in seconds): optional stagger between launching each instance (e.g., 1 second)

## Step 3: Click Execute

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 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 testcase run