> For the complete documentation index, see [llms.txt](https://docs.aohwv.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aohwv.dev/getting-started/03-deploy.md).

# Step 2 — Azure Marketplace Deploy

With your App Registration complete, you are ready to deploy the AOH Sync VM from the Azure Marketplace. Filling in the form takes a few minutes; Azure then provisions the VM in approximately **2–3 minutes**.

{% stepper %}
{% step %}
**Find AOH Sync in the Marketplace**

In the [Azure Portal](https://portal.azure.com), search for **AOH Sync** in the Marketplace and click **Deploy**.
{% endstep %}

{% step %}
**Fill in the deployment form**

Complete each field in the Marketplace form:

| Field                                     | What to enter                                                                                                                                                 |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Virtual Machine Name**                  | A name for the VM resource (for example, `aoh-sync-vm`)                                                                                                       |
| **Admin Username**                        | The SSH user for the VM (note this value — you'll need it for CLI maintenance)                                                                                |
| **VM Size**                               | **Standard\_D4s\_v3 or larger** recommended for production (Standard\_D8s\_v3 and Standard\_D4s\_v5 also recommended; Standard\_D2s\_v3 is the minimum)       |
| **OS Disk Type**                          | **Premium SSD** recommended for production                                                                                                                    |
| **OS Disk Size (GB)**                     | **64 GB minimum**                                                                                                                                             |
| **AOH Sync License Key**                  | Your license key in the format `CS-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`                                                                                             |
| **Domain (FQDN)**                         | The fully qualified domain name where AOH Sync will be accessible — for example, `sync.yourcompany.com`. Enter the domain only; do **not** include `https://` |
| **Azure AD App Registration — Client ID** | The Application (client) ID from [Step 1 — App Registration](/getting-started/02-app-registration.md)                                                         |
| **Networking**                            | Select the subnet for the VM                                                                                                                                  |

{% hint style="warning" %}
**Do not enter your client secret here.** The Marketplace form and ARM template log deployment parameters — your secret is collected securely in the browser setup wizard (over TLS) in a later step. Entering it here would expose it in deployment logs.
{% endhint %}

AOH Sync carries your License Key, Domain, and Client ID from this form directly into the browser setup wizard — you will not need to re-enter them.

Click **Review + create**, confirm your settings, then click **Create**.
{% endstep %}

{% step %}
**Wait for provisioning**

Azure provisions the VM and writes your initial configuration automatically. This typically takes **2–3 minutes**. You can monitor progress in the Azure Portal under the deployment's **Overview** tab.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Once provisioning completes, note the **Public IP address** of the new VM — you will need it in the next step to create your DNS record.
{% endhint %}

## How to check it worked

The VM shows a status of **Running** in the Azure Portal, and you can see its **Public IP address** on the VM's **Overview** page.

## Related

* [Step 1 — App Registration](/getting-started/02-app-registration.md)
* [Step 3 — DNS](/getting-started/04-dns.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.aohwv.dev/getting-started/03-deploy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.