Skip to content

Install the Airgate appliance on VMware ESXi

This guide deploys Airgate as a virtual appliance on VMware ESXi or vCenter. At the end you have a running Airgate with its console on HTTPS, RADIUS, RadSec and TACACS+ listening, and a first administrator who can sign in.

  • The OVA file airgate-<version>.ova and its checksum file airgate-<version>.ova.sha256, from Airowire.

  • VMware ESXi or vCenter 6.7 or later (the OVA uses virtual hardware version 14), and rights to deploy an OVF template.

  • Capacity for the default size:

    Resource Default
    vCPU 4
    Memory 8 GB
    Disk 60 GB, thin provisioning is fine
    Network 1 adapter, VMXNET3
    Guest OS Ubuntu 24.04 LTS (automatic security updates on)
  • One static IP address on a network that your switches, access points, controllers and administrators can reach, with its prefix length, default gateway and DNS servers.

  • DNS names that point at that address:

    • the console, for example nac.contoso.com;
    • the name in the Wi-Fi (EAP) server certificate, by default radius.<your domain>, for example radius.contoso.com.
  • NTP servers reachable from the appliance (recommended; certificates and Active Directory need the right time).

  • Firewall rules:

    From To the appliance Purpose
    Switches, APs, controllers UDP 1812, 1813 RADIUS authentication and accounting
    Switches, APs, controllers, site connectors TCP 2083 RadSec (RADIUS over TLS)
    Switches, firewalls TCP 49 TACACS+ device administration
    Administrators, guests, site connectors TCP 443 Console, API, guest and BYOD portals, connector API (HTTPS)
    Guests, clients TCP 80 HTTP (portal redirects, certificate revocation)
    Administrators TCP 22 SSH to the appliance (optional)
    From the appliance To Purpose
    Appliance Network devices, UDP 3799 Change of Authorization and Disconnect
    Appliance Directories (LDAP / LDAPS, Kerberos) Account and group lookups
    Appliance Cloud services you integrate (Microsoft Entra ID, Intune, Google, CrowdStrike, SentinelOne) Directory and device data, over HTTPS
    Appliance DNS, NTP Name resolution, time

On your workstation, check the OVA against its checksum file before you deploy it.

Terminal window
sha256sum -c airgate-<version>.ova.sha256

On Windows PowerShell, compare the output of Get-FileHash airgate-<version>.ova -Algorithm SHA256 with the value in the .sha256 file. They must be identical.

  1. In the vSphere Client, right-click the host or cluster and select Deploy OVF Template.

  2. Choose airgate-<version>.ova.

  3. Name the virtual machine, for example airgate-01, and pick the compute resource.

  4. Pick the datastore. Thin provision is fine.

  5. Map VM Network to the port group of the appliance’s network.

  6. Finish the wizard. Do not change the CPU, memory or disk below the defaults.

  7. Power the virtual machine on and open its VM console (web or remote console).

At first boot the VM console shows the Airgate setup wizard. Answer its questions:

Question What to enter
Network: dhcp or static static (recommended for a NAC); dhcp is accepted
IP address with prefix For example 10.0.0.20/24
Default gateway For example 10.0.0.1
DNS servers Comma-separated, for example 10.0.0.5,10.0.0.6
Host name Fully qualified, for example nac.contoso.com
Restore from a backup of an Airgate appliance (rebuild)? n for a new installation. y replaces an existing appliance from its backup: see Rebuild an appliance
Console address Default https://<host name>. This is the address administrators use in the browser and the base of every link Airgate generates (portals, SSO, connector enrollment)
Name in the Wi-Fi (EAP) server certificate Default radius.<domain>. Devices see this name when they connect to 802.1X Wi-Fi
NTP servers Space-separated; empty uses the Ubuntu defaults
First console administrator (email) Default admin@<domain>
Console administrator password At least 12 characters
Organisation name (the first tenant) Default from the domain, for example Contoso
Appliance login password for user airgate At least 12 characters. Used on the VM console and for SSH

The wizard then applies the network, host name and NTP settings, generates the appliance’s own secrets (database password, signing keys and the master key that encrypts stored secrets), and starts Airgate. The first start takes a minute or two. It ends with:

Airgate is running.
Console: https://nac.contoso.com
Sign in: admin@contoso.com with the password you chose.
Point DNS for nac.contoso.com (and radius.contoso.com) at this appliance.

From then on, the VM console’s login screen shows the Airgate version, the console address and the appliance’s IP address.

  1. Open the console address in a browser, for example https://nac.contoso.com.
  2. The browser warns about the certificate: until you change it, the console’s HTTPS certificate is issued by the appliance’s own root certificate authority. Continue, or trust that root first (Step 5).
  3. Sign in with the first administrator’s email and password.

You are a platform administrator: you see every tenant and the Settings › Platform pages (Tenants, Software update, Backups). Create named administrators for your team under Settings › Administrators rather than sharing this account.

Choose one:

  • Use a certificate from a public CA (recommended): Certificates › Server certificates › Console HTTPS certificate › Upload custom. Upload the certificate, its private key and the chain. It is used from the next connection; no restart.
  • Keep the appliance-issued certificate: download the root from Certificates › Certificate authorities and install it as a trusted root on administrators’ computers (for example with Group Policy or Intune).

See Console access and certificates.

Before you add configuration, set a backup passphrase so that daily backups run: Settings › Backups › Schedule and passphrase. See Backups and restore.

Continue with Get started: add your first switch or access point, connect a directory and create an access policy.

Sign in on the VM console or over SSH as airgate and run:

Terminal window
sudo airgate-setup

It asks the same questions with the current answers as defaults and keeps the generated secrets. Use it to change the IP address, host name, console address, Wi-Fi certificate name, NTP servers or the appliance login password.

  • sudo airgate-compose ps shows the Airgate services, among them postgres, nacd and freeradius, running and healthy.
  • curl -k https://nac.contoso.com/healthz returns {"status":"ok", …}.
  • The console opens and you can sign in.
  • After you add a network device and an access policy, a test sign-in appears in Monitor › Sign-in log.
Symptom Cause Fix
The ESXi host client fails to import the OVA Large OVA upload through the host client Unpack the OVA and select the .ovf and .vmdk together
Setup ends with “Airgate is still starting” First start takes longer on slow storage Wait, then sudo airgate-compose ps; check sudo airgate-compose logs nacd
The console address does not open DNS not pointing at the appliance, or TCP 443 blocked Check DNS and firewalls; try https://<appliance IP>
Browser certificate warning The console certificate is issued by the appliance’s own root Upload a public certificate or trust the appliance root (Step 5)
Wi-Fi devices do not trust the server The device does not trust the appliance root, or expects another server name See Certificates and trust
Lost the administrator password See Reset a platform administrator password
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security