☁️ Nextcloud Backup
Keep an automatic off-site copy of your backups on Nextcloud — and restore any of them back.
The Nextcloud Backup page (under Settings) pushes a complete backup of this system to a Nextcloud folder, so you always have an off-site copy you can restore from — even if this server is lost. It sends the same .zip as the Backup & Restore download (all linen data + the connection settings + the server .env).
Setting it up
- Open Settings → Nextcloud Backup.
- Enter the Base URL of your Nextcloud (including
https://and the port if it isn’t 443, e.g.https://nc.example.com:8443). - Enter the Username and an App password — in Nextcloud go to Personal → Security → “Create new app password”. An app password is required if the account uses two-factor or SSO, and can be revoked any time without changing the login.
- Set the Backup folder (created automatically) and the retention — how many hourly, daily and monthly copies to keep.
- Tick Push a backup to Nextcloud every hour to turn on the automatic off-site copy, then Save.
Note Use HTTPS with a valid certificate — a backup carries credentials, so it must travel encrypted. “Allow insecure connection” (which skips certificate checks or permits
http://) is only for a trusted internal server and is best left off.Testing and pushing on demand
- Test connection checks that the server is reachable and the username / app password work — without changing anything.
- Push a backup now uploads one immediately (it works even while the hourly push is switched off, so you can verify it before enabling).
- When enabled, a backup is pushed every hour. Retention is grandfather-father-son: it keeps the newest backup per hour for the last (default) 24 hours, per day for 30 days and per month for 12 months — so a problem noticed weeks later still has a clean copy — and prunes the rest automatically.
- The page shows the last push result. If a push fails (e.g. a rotated app password or an expired certificate), it is shown here and the nightly health check also raises it — so a silent off-site-backup failure gets noticed.
Restoring from Nextcloud
The page lists the backups currently on Nextcloud (newest first). To restore, pick one, type RESTORE to confirm, and press Restore selected.
Note Leave “Keep current backup & email settings” ticked (the default) so restoring an older backup can’t silently switch off your off-site backup or blank the Nextcloud / email credentials — a restore should never disable your own disaster recovery. Untick it only when you deliberately want the backup’s own email / Nextcloud settings. The same option is on the Backup & Restore page.
Watch out Restoring replaces all current data and settings of this system with the chosen backup. A pre-restore snapshot of the current state is saved first (so a mistaken restore is recoverable), but this is destructive — use it with care. If the restore changed the identity / PMS settings you may need to sign in again.
Watch out The backups contain credentials in clear text (OIDC / PMS / fleet keys and, from
.env, the session secret and the built-in superuser login). Use a Nextcloud account and folder that only trusted administrators can reach.