Skip to main content

Auto-distributed executions

How it works

  • Katalon Studio version 8.0 onwards
  • Katalon Runtime Engine
  • Agent version 1.7.0 onwards
  • At least 2 active Agents

In Katalon TestOps, you can execute tests in parallel. During parallel execution, test runs are automatically load-balanced. This means that each time a test run starts, the test run is distributed to an available and active local test environment, minimizing execution time.

When a test run is executed, the test sessions will be assigned to the previously configured Agents in this order of priority:

  • Idle Agents
  • Agents that have not exceeded their Threshold
  • Agents with the least number of queued Test Runs

When an Agent completes a test run session, queued jobs that were first assigned to other Agents can be automatically reassigned to this Agent for immediate execution.

Configure Auto-distributed executions

  1. To enable Auto-distributed executions, make sure that you have at least 2 active Agents. You can learn how to set-up Agents here: Create a Local Test Environment.

  2. Make sure that your test suite collection is configured for parallel execution. If not, you can follow these steps: Run multiple Test Suites in Parallel.

  3. Create a test schedule and assign your test run types to those Agents. Learn more: Schedule Test Runs.


    When configuring multiple rest run types, test run types must share a minimum of 1 mutual Agent for distributed execution. In other words, assign test run types to multiple, overlapping Agents.

  4. Activate your Agents before the scheduled test run time.

  5. Once the test run types execute, the test sessions of these test run types are assigned to the previously configured agents automatically.