Azure Startup Guide

The Aviatrix cloud network solution consists of two components, the controller and gateways, both of which are Azure VMs. Gateways are launched from the controller console to specific VNets. This guide helps you to launch the controller VM in Azure. Make sure you follow the instructions to also subscribe to the Aviatrix Companion Gateway described in this guide.

1. Subscribe to the Aviatrix Controller

Go to Azure Marketplace to subscribe to one Aviatrix image.

2. Subscribe to an Aviatrix Companion Gateway

The Aviatrix companion gateway needs to be subscribed as programmable.

In order to launch an Aviatrix gateway from the controller, you must also subscribe to the Aviatrix Companion Gateway, which is free in the Azure marketplace. Follow the steps in this doc to subscribe.

3. Launch the Controller

Create an Azure Account

Create an Azure account if you do not already have one.

Launch Controller VM from Azure marketplace portal

  1. Launch from marketplace, select the license type and click Create Virtual Machine, as shown below. If you select a “BYOL” image, you need a Customer ID. Send email to or to request a Customer ID.


  2. From the dropdown menu select one option, for example the BYOL option.


  3. At Basics header, create new Resource Group titled “aviatrix” , virtual machine name can be “aviatrixController”. For instance size we recommend at least 8GB of RAM so B2ms should be sufficient. Next enter a username, password and Resource group, click OK.


  4. At the networking header, this will be preconfigured with a default subnet and security group. You should not need to change anything here.


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

  6. Finish launching the VM by hitting the create button.

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


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

  9. At the login page, enter admin as the username. The Initial password is the internal IP address of the VM, as shown below.


  10. Go through the login process.

  11. Start with 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.

4. Onboarding

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.

5. Gateway Troubleshoot

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