> For the complete documentation index, see [llms.txt](https://docs.simplifyqa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplifyqa.ai/marketplace/integrating-with-cloud-platforms/vm-based.md).

# VM Based

SimplifyQA supports seamless execution of test cases on cloud infrastructure through VM-based integration.

### Prerequisites

Before setting up the configuration, ensure the following:

* SimplifyQA cloud subscription.
* Active SimplifyQA agent
* Proper access rights and credentials (username/password or private key)

### Setting Up VM-Based Cloud Execution

To enable VM-based test executions from SimplifyQA, you first need to configure the cloud machine that will host your test runs.

#### Configuration Steps:

1. Log in to SimplifyQA and navigate to the **Marketplace** from the left-hand panel.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FdcnBitxD9SyxZxUBjQ2V%2Fmarketplace.png?alt=media&amp;token=f2c9b264-561d-43d5-aa40-9a3881a14c98" alt="" width="208"><figcaption></figcaption></figure>

2. Click on **Configure** under the **VM-Based Execution** card.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FFrfzsd0fdx40Dhk6jaQF%2Fv%20configure.png?alt=media&amp;token=47bbad53-f170-46bb-b6ff-f1976a632570" alt="" width="563"><figcaption></figcaption></figure>

3. Select '**+ VM Configuration'** to begin adding a new configuration.
4. Fill Out Configuration Details:
   * **IP Address:** Public IP of the cloud VM.
   * **Mount Path:** Shared path to store project files.
   * **Image Name:** The name of the Jar field that contains the latest custom test logic which the user wants to use.
   * **Maximum Container Count:** It defines how many test containers (parallel executions) a VM can handle simultaneously, based on its system capacity. This limit ensures optimal performance without overloading the machine. You can distribute these containers across multiple projects—for example, if a VM supports 10 containers, you might allocate 5 to Project A and 5 to Project B. Each project will then run tests independently up to its assigned limit, while any excess executions will queue until a slot is free. This helps efficiently manage shared cloud resources in multi-project environments.
   * **Username & Password:** Credentials for accessing the machine. These credentials are required to establish an SSH connection with the VM. SimplifyQA uses this access to deploy and run tests.
   * **SSH Port:** Port used for SSH connections (usually 22, change if your VM uses a custom port).
   * **Projects:** Select projects that should have access to this configuration.
   * **Private key authentication:** It is recommended for better security, especially when connecting to cloud-hosted VMs like AWS EC2, Azure VMs, or Google Cloud instances. It prevents brute-force attacks.\
     Private key authentication involves uploading the private key that corresponds to the public key stored on the VM, enabling seamless and secure login

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2F6VjqyMwwh1FOkazlsrCm%2FVM%20Details.png?alt=media&amp;token=6944ca21-f5c1-4ba1-bf35-70059889d883" alt="" width="563"><figcaption></figcaption></figure>

5. Click **Save** to finalise the setup

Once configured, this VM setup can be used as the target environment when setting the Execution Type to Cloud in your test case, suite or pipeline settings.
