Back to docs index

Cloud Sync

Termial's cloud sync keeps your connections, settings, and credentials synchronized across all your devices. Sign in once and access everything everywhere.

What Syncs

When cloud sync is enabled, the following data syncs across your devices:

  • SSH Connections - All your saved connections with settings
  • Cloud Connections - AWS, GCP, Azure configurations
  • Credentials - Passwords and SSH keys (encrypted)
  • Bookmarks - Your saved local path bookmarks
  • AI Settings - Model preferences and configuration
  • Docker Settings - Docker executable path

Note: Known hosts are stored locally and don't sync for security reasons.

Setting Up Sync

Sign In

  1. Go to Settings → Account
  2. Click Sign In
  3. Choose your sign-in method:
    • GitHub - Sign in with your GitHub account
    • Google - Sign in with your Google account
    • Email - Create an account with email and password

Set Up Encryption

After signing in, you'll set up encryption:

  1. Create a strong passphrase (at least 8 characters)
  2. Confirm your passphrase
  3. Click Set Up Encryption

Your data is now encrypted and will sync automatically.

See Encryption & Security for details on how your data is protected.

Sync Status

The sync status is shown in the app:

  • Synced - All data is up to date
  • Syncing... - Data is being synchronized
  • Not synced - Changes pending upload
  • Connection error - Unable to reach servers (click to retry)

Last Synced

See when your data was last synced in Settings → Account.

Manual Sync

Sync happens automatically, but you can force a sync:

  1. Go to Settings → Account
  2. Click Force sync

This uploads any local changes and downloads any remote changes.

Data Conflicts

If you make changes on multiple devices before syncing:

  1. Termial detects the conflict
  2. It uses timestamps to determine the most recent changes
  3. The most recent changes win

To avoid conflicts, ensure devices are synced before making changes.

First-Time Sync on New Device

When signing in on a new device:

  1. Sign in with your account
  2. Enter your encryption passphrase
  3. Your data downloads and decrypts
  4. All your connections and settings are available

Plans and Sync

Cloud sync availability depends on your plan:

PlanCloud Sync
Free❌
Pro✅
Team✅

Upgrade to Pro or Team to enable cloud sync.

Backup and Restore

In addition to cloud sync, you can export and import your data manually:

Export

  1. Go to Settings → Backup
  2. Click Export Settings
  3. Choose where to save the backup file
  4. The file contains all your connections, credentials, and settings

Import

  1. Go to Settings → Backup
  2. Click Import Settings
  3. Select your backup file
  4. Review what will be imported
  5. Confirm to import

Note: Importing replaces your current data. The imported data will sync to the cloud if you're signed in.

Signing Out

When you sign out:

  • Cloud sync is disabled
  • Local data remains on the device
  • Encrypted data stays secure

To sign out:

  1. Go to Settings → Account
  2. Click Sign Out
  3. Confirm

Sign in again to resume syncing.