> For the complete documentation index, see [llms.txt](https://docs.cloudbrink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudbrink.com/configuration/connector-deployment/connector-installation-azure.md).

# Connector Installation - Azure

**Introduction**&#x20;

This document will guide you to create an active-standby Cloudbrink Connector in Azure. Steps 7 through 10 must be completed twice in order to create two instances for the active-standby pair.

**Prerequisites**&#x20;

● A hosting Linux VM with free space greater than 50 GB in Azure region where the Cloudbrink connector image needs to be downloaded is recommended to speed up transfer times, however it is not required&#x20;

● A Storage Account service with container in the same region where the image needs to be created

**Connector VM Requirements**&#x20;

● OS: Ubuntu 22.04&#x20;

● Compute: 4 CPU and 8GB RAM and 50GB disk space&#x20;

● Networking: ○ Inbound port 22 for SSH and active-standby keepalive ○ Outbound TCP port 443 and 9090, and UDP ports 9993 and 9994 to Cloudbrink SaaS and Edges&#x20;

● Username: cbrink (required for hardening scripts)

***

## Create Connector VM from VHD file&#x20;

<br>

1. Download the Cloudbrink Connector managed disk snapshot from the following URL (Azure Public Storage Account) using curl command.&#x20;

Download Disk Image file from link below (15 days validity)&#x20;

<https://cbconnector.blob.core.windows.net/hyperv/connector-ubuntu-2204-amd64-v14.4.16.vhd?sp=r\\&st=2025-08-14T16:15:40Z\\&se=2026-08-15T00:30:40Z\\&sv=2024-11-04\\&sr=b\\&sig=Uh2ytS1Rh%2BuIuUDPc9nlisLOLMX4gbzMdED%2F%2Bu2MDJU%3D&#x20>;

2. Upload the managed disk image VHD file to the container in the existing storage account using Azure UI console or CLI.&#x20;

Command:&#x20;

$ az storage blob upload --account-name \<qos-storage-account-name> --container-name \<qos-container-name> --name \<file-name-of-VHD-file>&#x20;

Example:&#x20;

$ az storage blob upload --account-name blobuploadtest --container-name testcontain- er --name connector-ubuntu-2204-amd64-v14.4.16.vhd --file connector-ubuntu-2204-amd64-v14.4.16.vhd&#x20;

3. Create an image from the uploaded VHD file in the required region using Azure CLI.&#x20;

Command:&#x20;

$ az image create --resource-group \<qos-resource-group> --name \<image-name> --source \<qos-sa-blob-url> --location \<required-region> --os-type Linux&#x20;

Example:&#x20;

$ az image create --resource-group ven-test-rg --name connector-ubuntu-2204-amd64-v14.4.16.vhd –source <https://blobuploadtest.blob.core.windows.net/testcontainer/connector-ubuntu-2204-amd64-v14.4.16.vhd> --location westus --os-type Linux&#x20;

4. In Azure portal, navigate to All Services > Compute> Images.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FFI7L5jnqSkmGdtGAhapt%2Fimage.png?alt=media&amp;token=d34d5f3c-c69b-460e-b706-033b76288460" alt=""><figcaption></figcaption></figure>

5. On the Images page, select the newly created image and navigate to its overview page.

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2Fb6k8vWFT6r1ApSPdW7Sk%2Fimage.png?alt=media&amp;token=85995d6c-5bbc-443c-b1ad-859e78bc1055" alt=""><figcaption></figcaption></figure>

6. Click on the Create VM link located in the header to create a new connector VM.

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FCuLaBSdQZe5OPGm2NgH1%2Fimage.png?alt=media&amp;token=560ed69d-2a51-416f-988c-f9f6c4a9c9d2" alt=""><figcaption></figcaption></figure>

7. Within the Instance Details section of the Basics tab, ensure the Availability Options has “No infrastructure redundancy required” selected.

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2Fc6JQOhE3dF03GIB5wVfg%2Fimage.png?alt=media&amp;token=63a5b1a5-1393-47ea-8097-f15627992177" alt=""><figcaption></figcaption></figure>

8. Within the Administrator Account section of the Basics tab, ensure the Username is set to cbrink (this is required for our hardening script).

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FJHmhP38vzVbXZAoPGCdQ%2Fimage.png?alt=media&amp;token=c6b8a285-f5bc-426b-903a-416fb31ae4bc" alt=""><figcaption></figcaption></figure>

9. In the Networking section of VM creation, ensure that the Public IP type is set to “Basic” to ensure the Cloudbrink Connector retrieves its public IP details from Azure’s metadata.

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FB4Ek3Szbx1kFyGbtorKH%2Fimage.png?alt=media&amp;token=1f80c4d2-fa1e-42fa-b498-23f1c4e09c07" alt=""><figcaption></figcaption></figure>

10. In the Advanced tab, enable the “User-Data” and under the User-Data section with the below script, substituting in the provided OTP value.

\#cloud-config runcmd:

* \[bash, /opt/scripts/brink\_connector\_deploy\_cloud.sh, -o, "\<OTP\_VALUE>", -a, "1", -v, "", -p, "", -f, ""]

NOTE: The OTP mentioned in the above step can be generated from the Cloudbrink management portal → Configure → Connectors → “Select the connector which is already configured for Azure env” → click “Generate OTP”

11. The last step is to click “Review and Create” the image and instantiate the Connector VM image


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cloudbrink.com/configuration/connector-deployment/connector-installation-azure.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
