> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/settings/automation-settings/cloud-runner-settings.md).

# Cloud Runner Settings

The **Cloud Runner Settings** page allows you to manage **cloud runner pools**—groups of test runners that can be assigned to specific projects for executing automated tests.

By default, every organization has a **Default** runner pool, which you can edit or replace with your own.

***

#### Steps to Access Cloud Runner Settings

1. In the **left navigation panel**, click **Admin → Settings → Automation Settings → Cloud Runner Settings**.
2. The **Cloud Runner Settings** page will be displayed.

***

#### Page Overview

The page is divided into two sections:

| **Cloud Runner Settings**        | Displays all configured runner pools.                                   |
| -------------------------------- | ----------------------------------------------------------------------- |
| **Runners in the Selected Pool** | Lists all runners (cloud and on-premise) included in the selected pool. |

#### Cloud Runner Settings Table

| **Name**                 | <p>The name of the cloud runner pool.<br>By default, a pool named <strong>Default</strong> is created for your organization.</p> |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **Assigned to Projects** | The list of projects assigned to the pool. Displays `<All>` if the pool applies to all projects.                                 |
| **On-Premise Runners**   | Number of on-premise runners assigned to the pool.                                                                               |
| **Max Cloud Runners**    | The maximum number of cloud runners that can be deployed for test runs.                                                          |
| **Cloud Runners**        | The current number of active cloud runners.                                                                                      |

### Add a Cloud Runner Pool

1. On the **Cloud Runner Settings** page, click **ADD POOL** → The **Add Cloud Runner Settings** dialog will appear.
2. Enter the **Name**, set the **Max Cloud Runners**, and select the **projects** it applies to.
   * You can also check **Applies to All Projects** if the pool should cover all projects.
3. Click **SAVE** → The new pool will be added to the table.

***

### Edit a Cloud Runner Pool

1. On the **Cloud Runner Settings** page, right-click the pool you want to modify and select **Edit**.

   <figure><img src="/files/YW3P1bOYsmPCalUtHgNk" alt=""><figcaption></figcaption></figure>
2. Update the necessary fields in the **Edit Cloud Runner Settings** dialog.
3. Click **SAVE** to apply changes.

***

### Delete a Cloud Runner Pool

1. Right-click the pool you want to delete and select **Delete**.
2. Confirm your action in the **Confirmation** dialog.
   * Click **YES** to confirm deletion.
   * Click **NO** to cancel.

{% hint style="warning" %}
If you delete all test runner pools, you will not be able to run automated tests. Always keep at least one runner pool configured.
{% endhint %}
