Skip to content

Backups

The Backups page makes encrypted backups of the appliance: its database, settings, secrets and certificates. Restored on a rebuilt appliance, your CAs and server certificates stay the same, so devices keep connecting. Platform administrators use this page to set the backup passphrase and schedule, copy backups to an SFTP server, and restore.

Settings › Platform › Backups shows these cards:

Card Shows
Backups on this appliance Every backup file stored on the appliance.
Schedule and passphrase The daily schedule, how many backups to keep, and the encryption passphrase.
Backup server (SFTP) An optional server that receives a copy of every backup.
Restore a backup from a file Uploads a backup file and restores it.
History Past backups and restores.
Last log The log of the last operation, after you select Show the last log.

Banners at the top warn when no passphrase is set (Set a backup passphrase: no backup is made until it is set), when the last scheduled backup did not run, or when the backup settings cannot be read. While a backup or restore runs, a card shows the current step and the live log; during a restore the page reads Airgate is restarting… and keeps checking every 2 seconds.

If the console is not running on an Airgate appliance, the page shows only a note that backups are made by the appliance.

Column Meaning
Made When the backup was made.
Version The Airgate version that made it.
Size File size.
Backup server copied or copy failed (hover for the error), or — if no backup server is set.
File The backup file name.
Field Meaning
Daily backup Turn on and pick a time of day for an automatic backup. The hint shows the next run, or Off: back up by hand only.
Keep on the appliance 1 to 365. The number of newest backups kept in /var/lib/airgate/backups.
Passphrase / New passphrase At least 12 characters. When a passphrase is already set, leave empty to keep it.
Repeat Must match the passphrase.

The passphrase is stored on the appliance (readable by root only) so scheduled backups run unattended. Each backup keeps the passphrase it was made with.

Field Meaning
Copy backups to a backup server Turns the copy on or off. Turning it off and saving removes the server.
Host Required, for example backup.contoso.com.
Port Default 22.
User Required.
Directory For example /backups/airgate. Empty uses the user’s home directory.
Keep on the server Number of backups kept on the server. Default 30; 0 keeps all.
Sign in with Password or Private key.
Password When a password is stored, leave empty to keep it.
Private key (PEM, without a passphrase) Add its public key to the user’s authorized_keys on the server. When a key is stored, leave empty to keep it.
Server key pinned The SSH host key Airgate accepted. A server with another key is refused.

Upload an airgate-backup-….agbk file made on this or another Airgate appliance. Its database, settings, secrets and certificates replace this appliance’s; the network settings stay. To rebuild an appliance, restore in the setup wizard of the new appliance instead.

The Restore a backup window asks for Passphrase of the backup (empty uses the passphrase stored on this appliance) and then shows what the backup contains:

Field Meaning
Appliance The host the backup came from.
Made When it was made.
Version The backup’s version and the version installed here.
Console address The console URL stored in the backup.
Wi-Fi server name The RADIUS server name stored in the backup.

If the backup cannot be restored here, the reason is shown. For some version mismatches a Restore anyway option appears.

Column Meaning
Action Backup or Restore.
Started by console, scheduled or command line.
Result done, failed or running.
Started Start time.
Details The error, or the backup file name.
Action What it does
Back up now Makes a backup immediately. Needs a passphrase.
Download Downloads the backup file.
Restore Opens Restore a backup for that file.
Delete After confirmation, removes the backup from the appliance. Copies on the backup server stay.
Save (schedule) Saves the schedule, retention and passphrase.
Save (backup server) Saves or removes the SFTP server settings.
Test Connects to the backup server and checks that the directory is writable. On the first successful test, the server’s host key is pinned.
Upload Uploads a backup file in 8 MiB chunks, then opens Restore a backup.
Check the backup Decrypts and inspects the backup with the passphrase.
Restore (in the window) Type RESTORE to confirm. The database, settings, secrets and certificates become the backup’s. Airgate restarts, sign-ins pause for a few minutes, and everyone is signed out. If the restore fails, the current state is put back. If the backup came from another appliance, sign in again with its administrators.
Show the last log Loads the log of the last backup or restore.
  • View: platform:admin: Platform Administrator only.
  • Change: platform:admin: Platform Administrator only.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security