Skip to content

Multiple servers

monikapurpl3 edited this page Aug 21, 2026 · 1 revision

Multiple servers

Save as many Breeze Core servers as you like and switch between them instantly — a flat and a holiday house, or a production server and one you are testing.

Settings → Server lists them all: switch, rename, add another, or forget one without touching the rest.

Each server keeps its own credential in the Android Keystore. That is the part that matters: returning to a server you have used before needs no re-pairing, which would otherwise mean getting an admin onto that server's LAN — awkward when it is 400 km away.

Migration from a single-server install

An install from before 2.2.5 migrates into a profile on first launch. The migration writes the new keys before deleting the old ones, so an interrupted migration retries instead of losing your credential.

Forgetting one

Forgetting a server deletes the app's copy of that credential. The server still lists the device until an admin revokes it:

breeze-core devices
breeze-core revoke <token-id>

Device labels were never identity — the server keys on a token id — so a duplicate name is harmless, just unhelpful to a human. That is why pairing generates names like Sirocco-4820937 instead of proposing "Breeze" every time.

Clone this wiki locally