---
url: https://clusto.app/docs/cloud-sync.md
description: >-
  Account cloud sync - end-to-end encrypted, zero-knowledge sync of saved
  connection profiles and app settings across Clusto apps, including profile
  deletion and conflict behavior.
---

# Account Cloud Sync

When you are signed into a Clusto cloud account, your saved connection profiles and
app settings can save to the cloud automatically and sync to every other app
signed into the same account, whether that is the desktop app, the Android app,
or the web client.

Sync is **end-to-end encrypted (zero-knowledge)**. Everything is encrypted on the
device with a separate **sync passphrase** before it leaves, so the cloud only
ever stores ciphertext. The cluster tokens embedded in your connection profiles
never reach the server in the clear.

Cloud sync is included on every plan, including free Personal. It is opt-in
and off until you enable it. It is separate from
[Cluster Preferences](/cluster-preferences), which shares theme and UI settings
between clients on one cluster via the daemon; cloud sync instead ties settings to
your Clusto **account** and works even when your devices never share a cluster.

## What gets synced

* **Saved connection profiles** - the host, port, and cluster token for each
  connection you have saved, so a new device can reach your nodes without
  re-entering anything. Profile additions, edits, renames, and deletions all
  sync across your devices.
* **App settings**, including:
  * Terminal padding, font, and key bar
  * Notes view preferences
  * Theme
  * [Session colors and title template](/appearance#session-colors-and-titles)
  * Pinned terminals, chats, projects and sidebar folders, including the
    [unified workspace](/unified-workspace) folders

New settings the app adds under the same synced scope are picked up
automatically. Settings that describe the device itself stay on it: battery
saver, on-screen keyboard mode, panel widths, and open tabs. The full list is in
[Cluster Preferences](/cluster-preferences#device-local-keys).

## The sync passphrase

Cloud sync uses a **separate sync passphrase**, not your account login password.
This is what makes the sync zero-knowledge: the passphrase never leaves the
device, and the server never sees it or your plaintext data.

* Encryption is **AES-256-GCM**.
* The key is derived from your passphrase with **PBKDF2 (600,000 iterations)**.
* Encryption and decryption happen entirely on-device. The cloud stores only the
  resulting ciphertext.

Because the server never holds the passphrase or the key, **a forgotten
passphrase is unrecoverable by design**. If you forget it, there is no reset:
set a new passphrase and re-sync from a device that still has your data. See
[Forgot your passphrase](#forgot-your-passphrase) below.

## Enable it

Go to **Settings > Account** and find the **Cloud sync** card. You must be signed
into your Clusto account first (see [Accounts & Licensing](/accounts-licensing)).

The card lets you:

* **Enable and set a passphrase** - turn cloud sync on for this device and choose
  your sync passphrase. Your current connection profiles and settings are
  encrypted and uploaded.
* **Pull from cloud** - this device takes the cloud copy as is. Connection
  profiles and app settings on this device are replaced with the cloud copy,
  personal profiles that exist only on this device are removed, and unsynced
  local changes are lost. The app reloads if settings changed. A confirmation
  dialog appears first.
* **Push to cloud** - the cloud copy becomes this device's state, and your other
  devices follow on their next sync. Local profiles are re-stamped as just
  edited so they win every newest-edit merge, and profiles that exist only in
  the cloud get deletion markers, so they are deleted on your other devices too.
  A confirmation dialog appears first.
* **Last synced** - shows when this device last completed a sync.
* **Turn off on this device** - stop syncing from this device. This does not
  delete what is already stored in the cloud or affect your other devices.

Background sync needs no button: edits push automatically (a pin or folder change
uploads within about 1.5 seconds), other devices pull when the app regains focus
or becomes visible and show the change live, without a restart, and conflicts
resolve newest-edit-wins with deletion markers. **Pull from cloud** and **Push to
cloud** are overrides for when one side must win outright.

You can also run them from the F1 command palette: **Cloud sync: pull from cloud
(replace this device)** and **Cloud sync: push to cloud (replace cloud copy)**
(shown while cloud sync is unlocked). They open **Settings > Account** and show
the same confirmation.

## Per-device unlock

The passphrase is remembered per device, so you only enter it once per device:

* On a device that already knows the passphrase, sync **unlocks silently** when
  you return, with no prompt.
* On a **fresh device** (a new browser, a phone, a reinstalled desktop app),
  signing in checks whether your account already has synced data. If it does,
  Clusto tells you so and offers an **Unlock** shortcut to the Cloud sync card,
  where you enter the passphrase once. After that, it is remembered on that
  device too.

Until you unlock, a fresh device shows only the profiles saved locally on it -
signing in alone does not bring your profiles down, because the cloud copy is
encrypted with a key only your passphrase can derive.

If you used **Turn off on this device**, that device stops offering the unlock
prompt at sign-in. The Cloud sync card still lets you turn it back on.

Entering the passphrase does not send it anywhere. It only unlocks the local key
used to decrypt what the cloud sent down.

## Sharing with a team

On a Team license, you can also share connection profiles with everyone on the
team through a separate encrypted team vault. A shared profile moves out of your
personal cloud sync into the team vault, so each profile belongs to exactly one
of the two. See [Team Profiles](/team-profiles).

## GitHub token

This is separate from cloud sync and is not zero-knowledge. If you link GitHub to
your Clusto account with repository access (the `repo` and `read:org` scopes, at
`clusto.app/account/connect-github`) so the [GitHub view](/github) can reuse it,
the GitHub token is stored in your Clusto account, encrypted at rest with a
server-side key. The server must be able to decrypt it, because it hands the
token to your signed-in app on request. Clusto never writes the token to logs or
the audit trail (only your GitHub login is recorded when it is issued), and the
app forwards it write-only to your chosen host node without keeping a copy. Unlink
GitHub from your account, or revoke the Clusto app in your GitHub settings, to
remove it. Your sync passphrase and the data it protects are not involved.

## Conflicts

Each encrypted cloud snapshot is guarded by a server-side revision counter, which
keeps devices from overwriting a newer cloud revision out of order. Clusto then
handles settings and connection profiles differently:

* **App settings merge per key.** Each device compares its settings with the
  last synced state, so a setting you changed on this device wins for that key
  and is pushed right after, while keys changed only on another device are taken
  from the cloud. A change made here is not dropped when another device synced
  at the same time. If both devices changed the same key, the most recent
  snapshot wins for that key.
* **Connection profiles merge by name.** Profiles that exist only on one device
  are kept, so turning on sync cannot erase an unrelated local-only profile. If
  two devices edit a profile with the same name, the most recently edited copy
  wins.
* **Profile deletions are explicit.** Deleting a saved profile records an
  encrypted deletion marker for that profile name. The marker syncs with the
  rest of the snapshot and wins over older copies of the profile, preventing an
  old device or cloud snapshot from making the deleted profile reappear. If you
  later create a new profile with the same name, that newer profile replaces the
  older deletion marker.

## Forgot your passphrase

There is no recovery path, by design. Because the passphrase never reaches the
server, no one, including Clusto, can decrypt your data without it.

If you forget it:

1. On a device that still has your data (any device where sync is already
   unlocked), set a **new** passphrase in the **Cloud sync** card.
2. Re-sync. This re-encrypts your current data under the new passphrase and
   replaces the ciphertext in the cloud.
3. On every other device, enter the new passphrase once to unlock.

If no device still holds your data, the old encrypted blob cannot be recovered.
Enable sync fresh with a new passphrase and re-add your connection profiles and
settings.
