Product

Product Features How to Compare Docs Screenshots Why

Start here

Getting started Download Guides Frequently asked questions

More

Security Support Roadmap About

Backup and restore

8 answers

One file that rebuilds the fleet somewhere else.

Looking for something specific

The searchable index covers all 326 answers at once and filters as you type.

288 Take a backup

Account, Backup. Type your password in the Take a backup panel and press Download a backup. The file is named with the date and time, so several of them sit together without overwriting each other.

Your password is what encrypts the file, which is why it is asked for.

backupdownloadexportarchive
289 What is in a backup?

Sites, pools, zones and access lists, TCP and UDP services, error pages, certificates, paid authorities, settings and accounts, plus the certificate files themselves.

Left out on purpose: node names, cluster membership and each server's identity. Those belong to the machines rather than to the configuration.

contentswhat is includedcertificatesscope
290 Where should I keep backups?
  • Not only on the load balancers. A backup that lives on the machine it protects is no help when that machine is what failed.
  • Somewhere access is controlled, because the file is equivalent to your private keys.
  • Somewhere you will still have access if you are locked out of this system, since restoring is how you get back in.

Delete old copies rather than letting them accumulate. Every one stays valid for as long as the keys inside it do.

wherestorageoffsiteretention
291 Restore a backup
  1. Account, Backup, Restore panel. Choose the file and type the password it was made with.
  2. Press See what is in it. This opens the archive and reports what it holds without changing anything.
  3. Read the report, especially the addresses it came from.
  4. Type restore in the confirmation box and press the button.

Take a backup of what is there now first, if there is any chance you will want it back.

restorerecoverimport backup
292 Rebuild the fleet on new servers

Build one node as normal, restore the backup onto it, then join a second node to it. The restore repoints DNS failover answers to the new nodes automatically, matching the kind of address, and reports anything it could not match by name.

The management network allowlist is deliberately not restored, because restoring it is a good way to be locked out of the system you are in the middle of recovering.

disaster recoverynew serversrebuildmigrate
293 That password does not open this backup

The password is the one that was typed when the backup was taken, which is that person's login password at that time. If they have changed it since, the backup still wants the old one. A backup taken by somebody else needs their password, not yours.

wrong passwordcannot openzip
294 What else is backed up for me automatically?
WhatWhere
Previous nginx configurations, before every apply/var/backups/nginx-fleet-manager
The configuration databaseDocker volume nfm-data
Certificates and keys/etc/nginx/nginxmgr/certs
Settings and secret keyThe .env file

Guard .env separately. Without it a restored database cannot read its own encrypted values.

automatic backupenvvolumefiles
295 Do tunnel workloads come back after a restore?

The configuration does. Each machine still points at the old load balancers, so run the enrollment command again on each one from the Tunnel page of the new fleet.

tunnelrestoreworkloadsre-enroll

Two fresh servers is all it takes

Ubuntu 22.04 or newer, root access, and about twenty minutes. The installer does the rest and it is safe to run twice.