Cloud sync
Cloud sync mirrors your profile recipes across devices. Sign in once on each machine and the profiles you opt in to sync show up everywhere. The mods themselves are re-installed locally from their original sources.
This is the only feature in Zephyr that requires an account. Everything else works fully offline.
What gets synced
Per-profile, when you opt in:
- The profile name and metadata.
- Mod recipes: source, package name, version, enabled state, custom load order.
- Per-mod configs that you've edited away from default.
What's not synced:
- The actual mod binaries (re-downloaded locally).
- Locally imported mods (those stay on the machine).
- Save games - Zephyr never touches game saves.
- App preferences (theme, language) - those are per-machine.
Signing in
Open the Profiles page and click Sign in in the page header. A browser window opens for the Discord OAuth handshake; once you authorize, Zephyr gets a token and the header swaps the Sign-in button for a pill showing your Discord avatar and display name.
You only need to do this once per machine.
Opting a profile in
On the Profiles page, each profile card has a cloud-upload icon once you're signed in. Clicking it uploads the active profile and links the local copy to the cloud entry.
A linked profile gets a Synced badge and the cloud-upload icon is replaced by a cloud-off icon for stopping sync. Pushes happen automatically on rename and on the auto-sync hook; pulls happen on launch when Pull before launch is enabled in Settings -> Miscellaneous.
On a new machine
- Install Zephyr, sign in with the same Discord account.
- On the Profiles page header the Restore button shows cloud profiles that aren't on this device yet, including ones that belong to a game other than the active one.
- Pick which to download. Zephyr fetches the recipe and re-installs the mods.
The first install takes as long as a normal install would. After that the profile is identical to the source machine.
Conflict handling
If you change the same profile on two machines, the latest push wins. To force a re-fetch from the cloud, enable Pull before launch in Settings -> Miscellaneous and relaunch the game.
Sharing with others
Cloud sync is for syncing your own profiles between your own machines. To share with a friend, use a profile code instead.
Signing out
Click the log-out icon on the avatar pill in the Profiles page header. Local profiles stay on the machine; sync just stops.
Privacy
Cloud sync stores the recipe metadata only - package names, versions, configs you edited. We don't track which mods you launched, when, or for how long. See Privacy & telemetry for the full list.