Follow these steps to download and deploy the Horizon Cloud Connector appliance for a pod deployment that uses the federated architecture with Azure VMware Solution (AVS). In the federated architecture, you must deploy Horizon Cloud Connector into the native Microsoft Azure infrastructure of your pod's environment.

Note: For background information on Horizon pod deployment architectures, see Horizon Pod Deployment Architectures. For detailed information about working with an AVS environment, see the Microsoft Azure documentation at

The following is a high-level overview of the steps required to deploy Horizon Cloud Connector into the native Azure infrastructure within your pod's environment:

  • Download the Horizon Cloud Connector VHD file.
  • Create an Azure storage container and upload the appliance VHD to that storage container.
  • Create a virtual machine (VM) image from the uploaded VHD.
  • Create the Horizon Cloud Connector VM from the VM image.



  1. Download the Horizon Cloud Connector disk image using the link provided in your subscription email.
    The Horizon Cloud Connector disk image is available as a VHD file compressed into a ZIP package after you log in to using your My VMware account credentials. Download and extract the VHD file to your local system.
    Important: To enable the most up-to-date features, download version 1.10 or later of the Horizon Cloud Connector disk image. Version 1.10 or later supports all Horizon Cloud features and services except for automated updates of Horizon Cloud Connector.

    The following features and services are not supported for Horizon pods in AVS when paired with Horizon Cloud Connector 1.9 or earlier:

    • Automated updates of Horizon Cloud Connector
    • Universal Broker and multi-cloud assignments
    • Cloud Monitoring Server (CMS)
    • Horizon Image Management Service
    Before uploading the disk image file to your AVS environment, you must first create an Azure storage container and share it using a shared access signature.
  2. In the Azure portal, navigate to your storage account and create a storage container for the VHD file. For more information, see
    During the creation of the shared access signature, a SAS token is generated. You must construct a storage account URL for the disk image file by appending the SAS token to the storage container URL.
    1. Open the storage container by navigating to Storage Account > Properties > URL. Take note of the storage container URL for the next steps.
    2. Create a shared access signature. Navigate to Storage Account > Shared access signature > Select Resource types and Generate SAS and Connection String. Take note of the generated SAS token for the next steps.
    3. Construct the storage account URL using this format:

      The following is an example of a storage account URL:
  3. Upload the disk image file to the storage account URL that you created.
    1. Download and install the AzCopy utility on the local system where you extracted the VHD file containing the Horizon Cloud Connector disk image.
      For more information about the AzCopy utility, see
    2. To upload the VHD file, run the following command in the AzCopy utility:
      azcopy cp <Path to extracted VHD file> “<StorageAccountURL>” --blob-type PageBlob

      The following shows an example of an upload command issued from a local Windows computer:

      azcopy cp c:\horizon-cloud-connector- "" --blob-type PageBlob
  4. Create a virtual machine (VM) image from the uploaded VHD file.
    1. In the Azure portal, navigate to Images and create a new VM image. Enter a name for the image, and specify the target location and resource group.
    2. Specify the following options:
      • Set the OS type option to Linux.
      • Set the VM generation option to Gen1.
    3. For the Storage blob, browse to the storage account and container that you created, and select the VHD file that you uploaded.
    4. Click Create to create the VM image from the VHD file.
  5. Deploy the Horizon Cloud Connector appliance by creating the appliance VM from the VM image.
    1. In the Azure portal, open the VM image that you created in the previous step. Click Create VM.
    2. Specify the following settings:
      • Enter a name for the new VM. This will be the hostname of the Horizon Cloud Connector appliance.
      • For VM Sizing, specify a value that is higher than “Standard_D4s - v3.”
    3. For the Administrator account, specify ccadmin as the user name. You must create this ccadmin user account in order to allow SSH access to the appliance.
    4. For SSH Access, specify the SSH Public Key authentication method.
      Note: Both SSH Public Key and Password authentication methods are supported. However, SSH Public Key provides stronger security and is the preferred method.
    5. For Firewall settings, configure the following ports:
      • Port 443 for HTTPS
      • Port 22 for SSH

      If you intend to configure a firewall and proxy server for the appliance, you must also configure the appliance to allow certain public URLs. For more information, see DNS, Ports, and Protocols Requirements When Using Horizon Cloud Connector and a Horizon Pod.

    6. For Network settings, specify a public IP Address allocation if you need to allow access to appliance over a public network. Also, specify the public inbound ports for HTTPS and SSH.
    7. Navigate to VM Properties and take note of the IP address and FQDN of the appliance VM. You will need this information later to access the browser-based Horizon Cloud Connector configuration portal.
  6. If your environment requires use of an HTTP proxy server for your virtual appliances to access the Internet, configure proxy-related settings for the appliance, as described in Modifying Proxy Settings for Horizon Cloud Connector 1.6 or Later.
  7. Configure the required certificates, as described in Configure a CA-Signed Certificate for the Horizon Cloud Connector Virtual Appliance.
  8. Complete the steps in Enable SSH Access to the Horizon Cloud Connector Using a Command Line Interface.
  9. If you want to use a fully qualified domain name (FQDN) for the Horizon Cloud Connector appliance and resolve the host name, create a forward and reverse lookup record in your DNS server that maps that FQDN to the Horizon Cloud Connector virtual appliance's static IP.

What to do next

Continue with the pod onboarding workflow by following the steps in Verify the Horizon Pod and Virtual Appliance Are Ready to Be Paired with Horizon Control Plane. Then proceed to Complete Pairing the Horizon Pod with Horizon Cloud Using the Horizon Cloud Connector Configuration Portal.