iCloud sync and recovery

For iPhone / iPad. Apple TV publishing has a separate switch.

Align versions first

Use oixCloud 1.34 or later on every syncing device. Versions 1.33 and earlier use a different sync system.

Enable sync

Chinese simulated interface with fictional data · Click to view full size

1. Use the same Apple Account and confirm iCloud works.
2. First enable the iCloud Sync switch on the main Settings page, then open iCloud Sync to select the categories you need.
3. Use Sync Now, wait for completion and check another device.
4. Verify with one recognizable configuration before reorganizing many items.

Categories cover proxies, rules, modules, MITM, automation, settings and accounts. Disabling a category stops its transport without automatically deleting its local contents.

Folders and newer data

Version 1.34 introduced the current sync system; it does not support every feature added later. Node folders start with 2.1.6 (520) and belong to the Proxies sync category. Before using folders, install a folder-capable build on each iPhone/iPad that needs to read them.

On the first upgrade to a folder-capable build, devices syncing Proxies fetch that sync zone again. Once folder records exist in iCloud, older builds that cannot read them skip those records and report that an update is required. This does not call for deleting cloud data or adding every node again.

Check each device's version and release channel, retain the device with complete data, then update, use Sync Now, and verify folder names and members. A device that cannot upgrade cannot validate sync of the new feature. Apple TV display and sync remain limited to what its own version supports.

Account changes and recovery

After an Apple Account change or cloud deletion, read the recovery choices carefully. Upload and Merge adds local content to the cloud. Use iCloud Data replaces local content in enabled categories with the cloud version, including empty categories.

First identify the device that retains complete data. Repeatedly deleting cloud data on every device is not a troubleshooting procedure.

Recently Deleted

Nodes and subscriptions deleted locally remain recoverable for three days. This recovery list is device-local and does not sync. Restoring an item does not restore your former connection selection.

Apple TV

Enable Sync to Apple TV on the phone/tablet and iCloud sync on TV. Nodes, subscriptions, chains, groups, rule sets and account state are shared; TV keeps its own connection/routing settings and does not receive modules. See Apple TV.

Check sync in order

1. Add a recognizable ordinary node or rule on the device with complete data, then use Sync Now.
2. On the other device, confirm the same Apple Account, main sync switch and relevant category, then sync.
3. Verify the item's contents before testing connectivity. Configuration sync does not complete system VPN permission or Tailscale authorization on another device.
4. For one missing category, check its switch. For TV-only failures, check both Sync to Apple TV and the TV's own switch.

Recently Deleted recovers local node/subscription deletions; it does not restore an entire cloud account or replace keeping a copy before bulk edits. Identify the device holding the desired version before choosing a replacement operation such as Use iCloud Data.