# Register your Machine

To execute tests  using SimplifyQA, you must first register your machine. This ensures the platform can communicate with your execution environment effectively.

{% hint style="success" %}
**Note:** When the agent is first installed and started, SimplifyQA automatically registers the machine by default. This registration feature can be used to manually register virtual or remote machines.
{% endhint %}

### Steps to Register your Machine

* Log in to SimplifyQA and click on your profile icon in the top right corner.
* From the dropdown menu, select **Settings**, then go to the **Configuration** section.

<figure><img src="/files/n8f5xPtH173poHmvLKSj" alt=""><figcaption><p>Profile Menu Navigation</p></figcaption></figure>

* Click on the **Registration** tab, and then move to the **Machine Registration** sub-tab.
* Click the '**+ Machine'** button to begin the registration process.

<figure><img src="/files/wHTCcFCyLDqHShv55dfk" alt=""><figcaption><p>Machine Registration Tab</p></figcaption></figure>

* Choose Machine Type:
  * **Local Machine:** If you're registering a local machine, details such as **Machine Name**, **IP Address**, and **Machine Address** will be automatically populated.
  * **Remote Machine:** If it's a remote machine, you'll need to manually input: Machine Name, IP Address, and Machine Address

<div><figure><img src="/files/0ejWg2wI1iBhiaiGYNpl" alt=""><figcaption><p>Local Machine</p></figcaption></figure> <figure><img src="/files/wGgSpo4aj14McFjdYxcd" alt=""><figcaption><p>Remote Machine</p></figcaption></figure></div>

* Once all necessary fields are completed, click on **Register**. Your machine will now be registered with SimplifyQA.&#x20;

<figure><img src="/files/yEGNo0nz4fQNLFqUusTP" alt=""><figcaption><p>Registered Machine</p></figcaption></figure>

* Color Indicators for Machine Status:

  * **Green**: The machine is registered and the agent is running successfully.
  * **Red**: The machine is either not registered or not active.
  * **Grey**: The machine is registered, but the agent is not currently running.

* You can delete any registered machine by clicking the delete icon next to it.

* To rename a machine, simply click on the machine’s name input field and make the necessary changes.

After successful registration, the machine becomes available for use in your test executions. Make sure the SimplifyQA agent is running on the registered machine to enable smooth communication and execution.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.simplifyqa.ai/simplifyqa-installation-and-setup/register-your-machine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
