Backup & Restore

Your setup — layouts, customizations, quick menus, settings — can be backed up and restored.

Export & Import

Export creates a backup file containing your configuration. Save it to Files, AirDrop it, or keep it as insurance before big changes.

Import restores from a backup file. Everything loads and syncs to your watch.

Every backup carries your server addresses in plain text — they’re how a restored device knows where to find Home Assistant, and they’re never enough to log in on their own. Your access token and HTTP Action secrets are different: they ride along only inside an optional, password-encrypted envelope that you turn on per backup. Leave that off (the default) and the file holds no credentials at all.

Caution

Because every backup includes your server addresses, a plain backup file points at your Home Assistant — but still can’t sign in without a token. If you turn the encrypted secrets on, treat the file like a password: anyone with both it and the password can restore your sign-in.

Backup Options

Every backup — Quick Backup, named, or file export — opens a Backup Options sheet first, so you decide exactly what goes into the file. It has two tiers.

Settings & Layout

A collapsed disclosure with an All N badge (or M of N once you customize). Everything is included by default — expand it only when you want to leave something out. Use Select All / Select None, or toggle individual categories.

Deselected categories are left out of the file entirely. That keeps backups focused, and it makes restores safe: a partial backup never carries — and so can never wipe — data it doesn’t include.

Categories you can pick from:

• Pages & Tiles — Your pages, the tiles on them, and tile styling
• Status Pages — Custom status pages and their rows
• Quick Actions — Per-tile quick menu (radial) configurations
• Page Switcher — The long-press page switcher overlay layout
• Entity Radial — Entity radial defaults per domain
• Voice Phrases — TTS phrases, speaker presets, default output
• Entity Presets — Complication/widget entity configurations
• Notification Styles — Notification appearance (background, button fill, colors, state badges)
• HTTP Actions — Your HTTP Action library, as a skeleton (URLs, headers, and bodies are stripped — those are secrets and only travel inside the encrypted envelope below)
• Action Chains — Your multi-step Action Chain macros
• Complications — Complication presets plus Control Center toggle and action entities
• Preferences — Navigation, interactions, sounds, dashboard flags, advanced-mode toggle, room mappings, and Point Control calibration

Each row shows a counter (pages, tiles, slots, phrases, presets) so you can see what’s inside before deciding.

Sensitive Data (encrypted)

A separate tier with its own master toggle. Turn it on and you set a password (minimum 8 characters, entered twice to confirm). The selected secrets are sealed with AES-GCM, the password stretched through PBKDF2-HMAC-SHA256 — so the encrypted blob is unreadable without the password, even to someone holding the backup file.

Three kinds are selectable independently — expand the tier to pick a subset, or use the master toggle for all of them:

• Server addresses — Your local and remote Home Assistant URLs
• Access token — Your long-lived sign-in token
• HTTP Actions — The request URLs, headers, and bodies stripped from the plaintext skeleton above (only available when the HTTP Actions category is included)

If you have secrets on the device but leave this off, the sheet nudges you so they aren’t silently left behind. Each toggle is disabled when there’s nothing of that kind to seal (not signed in, no HTTP Actions yet, and so on).

Caution

There is no password recovery. If you forget the backup password, the encrypted secrets in that file are gone for good — you’d just sign in manually after restoring everything else. The password is never stored or synced; it lives only for the moment you create the backup.

Partial Restore

When you restore, you don’t have to bring everything in. The picker shows the same two tiers as the Backup Options sheet, scoped to what the file actually carries — a partial backup only offers the categories it holds.

Settings & Layout defaults to everything in the file. Expand it to deselect categories; each row shows its counter so you can see what’s inside before deciding. Unchecked categories keep your current data untouched. Great for grabbing one chunk from a backup without wiping your current setup — pull just the complications from an old backup while keeping your current pages.

Restoring sensitive data

If the backup was made with the encrypted envelope on, the picker shows a Sensitive Data tier listing which kinds it contains. The secret kinds default on (you’re restoring this backup because you want them back), and you pick which to bring in — server addresses, access token, HTTP Actions, or a subset.

• Enter the backup password. Nothing is decrypted or applied until it’s correct.
• A wrong password fails inline — the error appears on the sheet and nothing on your device changes. Turn the secrets off and you can still restore everything else.
• When you’re restoring sign-in info, the app runs a connection check first: it tests the address and token you’d end up with before writing anything. If the check can’t reach the server or the token’s rejected, it parks the restore behind Restore Anyway / Skip Sign-in Data / Cancel rather than silently saving credentials that don’t work. (Being away from your home network is a normal reason for an unreachable result.)

Caution

A full restore replaces everything in the selected categories. Export your current state first if you want a safety net.

New watch or new phone

Back up with Sensitive Data on (a password and your sign-in token), then restore it with the secrets on, and your sign-in and working HTTP Actions come back automatically — no re-entering URLs, tokens, or request details on the new device.

iCloud Backups

Sign in to iCloud and the Backup & Restore screen exposes two flows:

• iCloud Quick Backup — Tap Backup to iCloud and the new snapshot joins a rotated history. The screen keeps your last 6 backups, newest first — the top one is tagged Latest. Tap any row to restore it, long-press to delete it. The list collapses to just the newest row; tap Show N more to see the rest.
• iCloud Named Backups — Save the current config under any name. Each named backup is a separate file with its own date and size. Tap to restore, long-press to delete. Use these when you want labelled snapshots (e.g. before a big rework).

Both flows open the same Backup Options sheet before saving, and the same restore picker as file imports — so you pick categories and (optionally) seal secrets either way.

Backups don’t sync automatically. Tap the button (or save a new named backup) whenever you want to capture the current state.

Sharing

Share your layout with family members: export, send the file, they import. For a clean handoff, leave Sensitive Data off — the file then carries no token, and the recipient signs in with their own Home Assistant credentials. (Your server addresses still travel in plain text; that just tells their app where your HA lives, not how to log in.)

Because the backup is per-category, you can also share just one piece — send a friend your complications presets, or your Status Pages, without exporting the rest of your config. Deselect everything else in the Backup Options sheet first.

Resetting

There’s no global factory-reset button. Each editor (entity radial, quick actions, individual status pages, individual page styles) has its own Reset to Defaults button that affects only that scope. To start completely fresh, delete and reinstall the app — your Home Assistant connection isn’t affected.