Azure Startup Guide

The Aviatrix cloud network solution consists of two components, the Controller and Gateways, both of which are Azure VMs (Virtual Machines). Gateways are launched from the Controller console to specific VNets. This guide helps you to launch the Controller VM in Azure.

Follow the instructions to also subscribe to the Aviatrix Companion Gateway described in this guide:


These instructions apply generally to both Azure commercial and Azure Government clouds for deploying an Aviatrix Controller. Note that some screenshots may show regions that are only available for commercial Azure accounts. Commercial Azure offers multiple regions worldwide while Azure Government offers four US regions: (US) USGov Virginia, (US) UsGov Arizona, (US) UsGov Iowa, and (US) UsGov. For more information about Azure regions, click here.

Subscribing to the Aviatrix Metered Offer

Go to Azure Marketplace to subscribe to Aviatrix Controller Meter License - PAYG.

Follow the Azure portal instructions to subscribe.

Subscribing to the Aviatrix Controller BYOL Offer

After you subscribe to Aviatrix Meter License offer, you should receive an email from to inform you with customer ID and a link to subscribe the actual Aviatrix Controller BYOL offer. More to continue in the Launching the Controller section below.

(Note with Aviatrix Meter License, you are billed monthly. No upfront cost and pay as you go.)

(Optional) Subscribing to an Aviatrix Companion Gateway

This step is not required for most of deployment scenarios as Aviatrix Controller automatically subscribes to the Aviatrix Companion Gateway when it is launched.

There are exceptional cases, such as if you provide Managed Service on Azure, the Aviatrix Companion Gateway requires manual subscription.

For manual subscription, follow the steps in this doc to subscribe.

Launching the Controller

Launching the Controller VM from the Azure Marketplace Portal

  1. In your Azure account, navigate to the Marketplace. Enter “Aviatrix Secure Networking Platform BYOL” into the search bar to find the correct subscription. Select this subscription and click Create.


  2. Create a new Resource Group titled “aviatrix.” The virtual machine name can be “aviatrixController.” For the instance size, at least 8GB of RAM is recommended; B2ms should be sufficient.

  3. Next, enter a username, password, and Resource group. Please do not use “ubuntu” as username if you use password as the authentication type.


  4. Click OK.

  5. At the networking header, this will be preconfigured with a default subnet and security group. You should not need to change anything here. For Public IP, click Create New.

  6. At Assignment, select Static and click OK.


  7. The management, advanced, and tag headers should not need any configuration changes.

  8. Click Create to finish launching the VM.

  9. Find the VM’s public IP address, as shown below:


  10. Use a browser to access the controller VM. In this example, it is

  11. At the login page, enter “admin” as the username. The initial password is the internal IP address of the VM, as shown below.


  12. Go through the login process.

  13. After logging in, click on the Onboarding tab at the console.


Any resources created by the Controller, such as Aviatrix gateways, Azure routing entries, subnets, etc, must be deleted from the Controller console. If you delete them directly on Azure console, The Controller’s view of the resources will be incorrect, which will lead to features not working properly.

Onboarding your Azure Account in the Aviatrix Controller

The purpose of Onboarding is to help you setup an account on the Aviatrix Controller that corresponds to an Azure account with policies so that the Controller can launch gateways using Azure APIs.

Follow the instructions here to create an Aviatrix account that corresponds to your Azure account credential.

Note: you can create a single Aviatrix account that corresponds to AWS, Azure, and GCloud account credentials. This is a multi-cloud platform.

Gateway Troubleshooting

If the Controller fails to launch an Aviatrix gateway in Azure RM, check out this troubleshooting guide.