How to Transfer Shadowrocket to a New iPhone: iCloud Sync, Config Export and Restore

Before switching to a new iPhone or iPad, back up your Config files and subscriptions. Learn how to sync with iCloud, export a Config file, restore your purchase, and import your setup on the new device.

At a glance

When moving Shadowrocket to a new device, handle the app purchase, Config files, servers and subscriptions in Home, and device settings in Settings separately. This guide is for anyone who can still use their old device and is preparing to move to a new iPhone or iPad. First save an offline copy, then check which files are available in iCloud, and finally restore and test each item on the new device. Don’t assume the transfer is complete just because the app has been downloaded again or the files have synced.

1. Separate your purchase, Config files and subscriptions

Your App Store purchase record lets you download the app again; it does not back up app data. Config files mainly contain settings such as rules and DNS. You’ll need to check servers, subscription links and the current selection in Home, as well as settings such as On Demand in Settings. Even if you use the system’s device-to-device migration, keep files and subscription details that you can restore independently.

3 areas
Check Home, Config and Settings separately
2 options
Sync files with iCloud or export a manual backup
4 connection modes
Global Routing:Proxy / Direct / Config / Scene

Before migrating, confirm which Config file the old device is actually using; don’t rely on the filename alone. Then note the selection under Home → Global Routing. If the old device uses Config, continue using Config after migration and select the corresponding file. If it uses Scene, also check the configuration and conditions referenced by that scene. Copying a rules file alone does not confirm that the new device is using the same connection mode.

2. Export the Config from your old device and check the backup

Export manually first so you don’t erase the old device before syncing finishes. Start with the active configuration on the old device. File actions may vary with the app’s language or interface updates; use the share or export action for the file in Config. Don’t mistake shared server details for a configuration file.

  1. Identify the active file

    Open Config, find the currently selected configuration, and view its contents. Note the filename and the selection under Home → Global Routing, and confirm that this is the file used for everyday connections.

  2. Export the file

    In Config, open the action menu for the file and choose the share or export option. In the system share sheet, select “Save to Files.” Keep the configuration file itself—don’t just copy its filename or preview text.

  3. Keep an offline copy

    Save one copy in an easy-to-identify folder under “On My iPhone,” then save another to iCloud Drive. Keep the copies in different locations; making two copies in the same synced folder is not an independent backup.

  4. Save subscription details

    Return to Home, check your existing subscriptions, and save the original subscription links and labels. For manually added servers, record the Type, address, port and authentication details for each one. If TLS is involved, keep necessary parameters such as SNI too.

  5. Open and check the copy

    Find the exported file in Files and confirm that it opens and contains the expected configuration sections and rules. If the export contains only a single server link, go back to Config and select the right item.

For example, preserve the original order and parameters of DOMAIN-SUFFIX, IP-CIDR, GEOIP and FINAL in the old configuration. If rules reference custom policy names, those policies must also exist on the new device. Complete rule text alone is not enough. Don’t rewrite FINAL just to migrate; doing so can introduce routing differences and make troubleshooting harder.

3. iCloud sync: confirm the file is available on the new device

iCloud Drive syncs files; it doesn’t guarantee that every Home and Settings state has synced. The easiest approach to verify is to save the exported Config file to iCloud Drive and retrieve it from Files on the new device. If Config offers an iCloud file option, check each file individually to confirm it appears and opens instead of merely checking that cloud sync is enabled.

Migration plan: transfer files through the cloud, keep an offline copy as a fallback

Using iCloud Drive
  • Sign in to the same Apple Account used for iCloud on both devices.
  • Go to Settings → Apple Account → iCloud → iCloud Drive and confirm that sync is enabled on this device.
  • On the new device, open the exported configuration in Files → Browse → iCloud Drive.
  • If a cloud-download icon appears, wait for the download to finish before importing the file.
Manual file transfer
  • Keep the exported copy under “On My iPhone” on the old device.
  • You can use AirDrop to send the file to the new device, then save it in Files.
  • On the new device, open the configuration with Shadowrocket, check it, and then select it for use.
  • If a file with the same name already exists, save a separate copy to avoid overwriting a working configuration.

The transfer is complete when the new device can open and use the target file. Signing in to iCloud, seeing the filename or installing the app is not enough on its own.

The iCloud account in system settings may differ from the account under App Store “Media & Purchases.” The former controls file availability; the latter controls your app purchase record. If files are missing on the new device, check the iCloud account, available storage and network first. If the app prompts you to buy it, check the purchase account. Handle these as separate issues.

4. Restore the app purchase and import the configuration on the new device

On your new iPhone or iPad, sign in with the App Store account used for the purchase and find Shadowrocket in your account’s purchased apps to download it again. You can also check the product page. Confirm that the developer is Shadow Launch Technology Limited and the app ID is 932747118. Refer to the App Store page for system requirements. Here, restoring your purchase means regaining the right to download the app; it does not mean looking for a button in Shadowrocket that restores all your settings.

The iPhone / iPad version is available on the App Store for a one-time purchase of $2.99; the Mac (Apple Silicon and Intel), Windows, Android and Linux versions are free. See the download page for platform-specific instructions. Buying the app does not include a service plan or replace a subscription from your existing provider.

  1. Download the app again

    Check the purchase account and app details in the App Store, then download the app again. If a price is still shown, check your purchase history and account first; don’t mistake a failed Config import for a purchase issue.

  2. Import the configuration

    Find the exported Config file in Files, then use the system share sheet to open it in Shadowrocket. If Shadowrocket isn’t among the first sharing options, expand the list of apps. After importing, return to Config, check the contents and select the file.

  3. Restore subscriptions

    In Home, tap “+” in the upper-right corner → Type → Subscribe. Enter a subscription link obtained from your service provider, save it, then update the subscription. If device migration has already restored the subscription, check its contents first to avoid adding it twice.

  4. Check the servers

    Compare the server Type, address, port and authentication details with the old device, then select the server you plan to use. Provider updates may change the order of the list, so don’t rely on the first entry being the same.

  5. Authorize the first connection

    Return to Home, check Global Routing, and start the connection. When the system first asks to add a VPN configuration, confirm that the request is from Shadowrocket, allow it, and complete any system verification.

5. Verify each item after restoring—not just the connection toggle

Turning on the connection only shows that the connection process has started; it doesn’t prove that the rules, servers and DNS match the old device. Change one variable at a time during testing: first use the same network and server on both devices, then test routing. Finally, check behavior when switching between Wi-Fi and cellular.

If the same server works on the old device but fails on the new one, compare the configuration and system authorization first. If it fails on both, check the current network and the information from your service provider. If the number of nodes changes after restoring a subscription, the provider may have updated its content. Don’t add unknown entries just to match the previous count.

6. Common migration issues and what to check

Why is Home still empty after importing a Config?

Check the imported file’s actual contents first. A rules configuration may not include servers or subscriptions. Go to Home → “+” → Type → Subscribe to add your own subscription, then update the list. For manually added servers, restore the original parameters; don’t guess passwords or ports from the protocol name.

Why isn’t the file in iCloud taking effect?

First finish downloading and open the file in Files. Then check in Config whether it has been imported and selected. Next, confirm that Home → Global Routing is set to the expected mode. A file being present, imported and selected are three different states; check each one.

Do I have to pay for the app again after switching devices?

Check the App Store purchase history using the account you originally used. The one-time $2.99 purchase for iPhone / iPad is separate from backing up your configuration; the Mac (Apple Silicon and Intel), Windows, Android and Linux versions are free. If the download status doesn’t match your purchase history, resolve the account or store issue before restoring your configuration.

Can I recover my configuration if I already erased my old phone?

Check iCloud Drive, exported files you saved elsewhere, and any available system backups in turn. If you only have a subscription link, you can import the server list again, but custom rules and local changes may not be recoverable. App purchase records cannot recreate data that has no backup.

Can I send a backup file to someone else to check?

First remove subscription links, passwords, UUIDs, keys and other authentication details from a local copy. Share only the rule snippets and error text needed to troubleshoot. Don’t share a full backup. If credentials have been exposed, ask your service provider how to replace or revoke them.

7. Keep the old device until you’ve confirmed the restore is complete

Keep at least one exported copy that matches the active configuration until the migration is complete. Finish updating subscriptions, validating rules and checking On Demand conditions on the new device before clearing the old one. A synced file is not a reliable sole historical backup, since accidental deletion or overwriting can also affect other devices.

Export a new restorable copy after any major changes to rules, DNS or manually configured server parameters. The value of a backup isn’t the number of files you keep, but whether you can use the files, subscriptions and parameter records to rebuild a working setup you’ve verified.

Download Shadowrocket