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.
Before you begin
Section titled “Before you begin”-
The OVA file
airgate-<version>.ovaand its checksum fileairgate-<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 exampleradius.contoso.com.
- the console, for example
-
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
Step 1: Check the download
Section titled “Step 1: Check the download”On your workstation, check the OVA against its checksum file before you deploy it.
sha256sum -c airgate-<version>.ova.sha256On Windows PowerShell, compare the output of Get-FileHash airgate-<version>.ova -Algorithm SHA256 with the value in the .sha256 file. They must be identical.
Step 2: Deploy the OVA
Section titled “Step 2: Deploy the OVA”-
In the vSphere Client, right-click the host or cluster and select Deploy OVF Template.
-
Choose
airgate-<version>.ova. -
Name the virtual machine, for example
airgate-01, and pick the compute resource. -
Pick the datastore. Thin provision is fine.
-
Map VM Network to the port group of the appliance’s network.
-
Finish the wizard. Do not change the CPU, memory or disk below the defaults.
-
Power the virtual machine on and open its VM console (web or remote console).
Step 3: Run the first-boot setup
Section titled “Step 3: Run the first-boot setup”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.
Step 4: Sign in to the console
Section titled “Step 4: Sign in to the console”- Open the console address in a browser, for example
https://nac.contoso.com. - 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).
- 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.
Step 5: Set the console certificate
Section titled “Step 5: Set the console certificate”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.
Step 6: Set up backups
Section titled “Step 6: Set up backups”Before you add configuration, set a backup passphrase so that daily backups run: Settings › Backups › Schedule and passphrase. See Backups and restore.
Step 7: Configure Airgate
Section titled “Step 7: Configure Airgate”Continue with Get started: add your first switch or access point, connect a directory and create an access policy.
Change settings later
Section titled “Change settings later”Sign in on the VM console or over SSH as airgate and run:
sudo airgate-setupIt 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.
Verify
Section titled “Verify”sudo airgate-compose psshows the Airgate services, among thempostgres,nacdandfreeradius, running and healthy.curl -k https://nac.contoso.com/healthzreturns{"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.
Troubleshooting
Section titled “Troubleshooting”| 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 |