The Aviatrix cloud network solution consists of two components, controller and gateway, both 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 Aviatrix Companion Gateway described in this guide.

Steps to 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. Select Create at the next screen.

  3. At Basics column, fill in the VM name, user name, password and Resource group, click OK.

  4. At Choose a size, select the VM size, click Select.

  5. At Settings, Click Network security group (This is a critical configuration step)


  6. Create a new security group, add an Inbound Rule for HTTPS port 443 for Inbound Traffic, Allow, as shown below. Make sure Source is Any, Service is HTTPS, Protocol is TCP, Port range is 443 and Action is Allow.


  7. After the new security rule is added, click OK.

  8. 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 username. Initial password is the internal IP address of the VM, as shown below.


  12. Go through the login process.

  13. Start with 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, controllers view of resources will be incorrect which will lead to features not working properly.

Subscribe to Aviatrix Companion Gateway

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


After login to the browser console, click Onboarding to go through a few steps of initial setup.

Once login, click on Help for Frequently Asked Questions (FAQs). All features have descriptions and should be self-explanatory.

For support, send email to

There will be an alert message on the Dashboard menu when a new release becomes available.

Gateway Troubleshoot

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