Back to Blog

Sync Your SSH Hosts Across Devices with iCloud

| BudgetSoft | 3 min read | Guides

If you use ProSSH on more than one device, manually recreating host configurations is tedious. With iCloud sync, your hosts and snippets stay in sync automatically.

What syncs

  • Host configurations — hostname, port, username, connection settings
  • Snippets — saved commands and scripts

These are synced via CloudKit (Apple's iCloud framework) and are tied to your Apple ID.

What does NOT sync

Your sensitive credentials never leave the device:

  • Passwords are stored in the iOS Keychain, which is device-local and protected by the Secure Enclave
  • Private keys remain on the device where they were created or imported
  • Passphrases are not synced

This is a deliberate design decision. iCloud is convenient, but SSH credentials are too sensitive to store in a cloud database — even Apple's. You'll need to set up authentication on each device separately.

How it works

Automatic sync

When you add, edit, or delete a host on one device, the change is pushed to iCloud automatically. Other devices pick it up in the background.

Changes are debounced — if you rapidly edit several hosts, ProSSH batches the updates into a single sync operation instead of hammering iCloud with individual changes.

Background sync

ProSSH uses iOS Background Tasks to sync even when the app isn't in the foreground. When a change is pushed from another device, your iPhone receives a silent push notification and syncs in the background.

Conflict resolution

If the same host is edited on two devices before syncing, the most recent change wins. In practice, conflicts are rare since edits are synced within seconds.

Setting it up

iCloud sync works automatically if:

  1. You're signed into iCloud on your device
  2. iCloud Drive is enabled for ProSSH

There's no setup required. Open ProSSH on a second device with the same Apple ID and your hosts will appear.

Privacy

  • Sync data is encrypted in transit and at rest by CloudKit
  • Host configurations are stored in your private iCloud database — only your Apple ID can access them
  • No BudgetSoft servers are involved. Data goes directly between your devices via Apple's infrastructure
  • We have no access to your sync data

FAQ

Q: Will my passwords sync? No. Passwords stay in the device Keychain. You'll need to enter them on each device.

Q: What about SSH keys? Keys do not sync. Generate or import keys on each device separately.

Q: Does it use my iCloud storage? Technically yes, but host configurations are tiny (a few KB). You won't notice any impact on your iCloud storage.

Q: Can I turn sync off? Yes, you can disable iCloud Drive for ProSSH in your device's Settings app.

Get ProSSH

iCloud sync is included in ProSSH. €14.99 on the App Store, one-time purchase.

Related posts