Backup and restore

Your settings, layouts, metrics and history all live in one database file. Settings → Backup and restore lets you download it, restore it, and roll back to one of the automatic snapshots.

Download a backupCopy Anchor Link

Press Download backup to save the whole database as a single file.

The passwords and tokens you've saved (for Solcast, MQTT, Home Assistant, Tuya, notifications and so on) are inside that file, locked with a key that stays on this box. That means if you restore the file onto a different box, those passwords can't be unlocked and you'd have to type them in again.

To take them with you, switch on Protect saved passwords with a passphrase before downloading, and choose a passphrase of 8 to 256 characters. The saved passwords in that file are then locked with your passphrase instead of the box's key.

A backup copied off the box is your real safety net: the daily snapshots live on the same card or disk as everything else.

RestoreCopy Anchor Link

Press Restore from file… and pick a backup. Everything is replaced with what's in the backup.

If the backup was made with a passphrase, Epilykos asks for it after the upload, then locks the passwords again with the new box's own key. A wrong passphrase is refused and you're asked again, and nothing is replaced until you give the right one or cancel. If you've lost the passphrase, Restore without saved passwords restores everything else and leaves the saved passwords empty.

A few things a backup doesn't include:

• Two-step sign-in: a restored box starts with it switched off.
• Tailscale: you'll need to connect remote access again.

Automatic snapshotsCopy Anchor Link

Every day, Epilykos takes a compressed snapshot of the database and checks that it's sound, and it keeps the two newest good ones. Press Restore next to a snapshot to roll back to it, or Refresh snapshots to update the list.

If a snapshot fails, or there hasn't been a recent one, Epilykos raises the Automatic snapshot failed or Automatic snapshot overdue event; you can choose to be told in Notifications.

Database healthCopy Anchor Link

Database health and backups shows when you last downloaded a backup, and the result of the last database check. Check the database now runs a check straight away. Epilykos also checks automatically a minute after an unexpected stop (a power cut, say), and once a week.

Once a month, a reminder asks you to download a backup; the daily snapshots don't count, because they stay on the same card or disk. Remind me about backups in 7 days puts it off for a week.