This guide is for Shadowrocket users moving to a new iPhone who already have their own provider and subscription. Follow this order: keep a copy on the old phone → check iCloud → restore servers in Home → import and enable Config → test the connection and check On Demand. iCloud sync is not a substitute for a separate backup, and exporting one Config file does not back up all app data. Keep the old phone until you have verified the new one.
Before migrating, distinguish servers, Config files, and system permissions
Home, Config, and Settings in Shadowrocket hold different data. Servers and subscription groups shown in Home provide connection destinations; Config files define rules, DNS, and other behavior; Settings contains app preferences. Seeing a Config file with the same name on the new device does not mean your server list, subscription sources, and all settings have been restored.
VPN permission is a system setting on the new iPhone. Even after data has been transferred from the old device, the first connection may prompt you to allow a VPN configuration. Treat credentials in server entries, tokens in subscription URLs, and sensitive fields in Config files as private data.
Before you start, note the name of the enabled Config file, the Global Routing selection, the server in use in Home, and the subscription group names. Avoid saving full subscription URLs or passwords in your regular photo library. Store credentials only in a secure location you trust.
Old iPhone: Save a copy before enabling iCloud
First, confirm that the current connection works on the old phone, then make a backup. This helps avoid mistaking an existing connection problem for a sync failure on the new phone. This guide does not provide, sell, or recommend servers or subscriptions; the steps assume you already have your own valid subscription and connection details.
-
Record the current setup
Open Home and note the server and subscription group in use. Go to Config and confirm which file is enabled. Then return to Home, check Global Routing, and note whether it is set to Config, Proxy, Direct, or Scene.
-
Save a copy of the Config file
In Config, open the action menu for the file you need and use the share or export option to save it in a recognizable folder in the Files app. Depending on the current interface, these options may be in the file's long-press menu or under more actions. Do not mistake deleting a file for removing it from the list.
-
Check iCloud Drive
On your iPhone, open Settings → your Apple Account at the top → iCloud → iCloud Drive, and make sure it is enabled for this device. Then check Shadowrocket in the list of apps using iCloud. If the list is collapsed, choose Show All.
-
Check app sync
Return to Shadowrocket → Settings → iCloud and check the available sync options and their status. If the menu or option names differ in your current version, follow the options shown in the app. Do not assume that an iCloud device backup means in-app sync has completed.
-
Make sure the file is accessible
Find the saved copy in the Files app and confirm it exists and can be previewed. If it is in iCloud Drive, wait for it to finish uploading. Keep another copy somewhere you can access independently before starting the restore on your new phone.
iCloud sync: Check your account and data flow
The account used to get the app from the App Store may differ from the account used for iCloud. To check whether data can sync, verify the iCloud account signed in at the top of Settings on both devices, rather than relying on App Store purchase history. Both devices also need a working network connection, enough iCloud storage, and permission for Shadowrocket to use the relevant iCloud features.
Migration roles: The old phone provides verified data; the new phone receives it step by step
Old iPhone
- Confirm that the existing servers in Home work.
- Save a separate copy of the currently enabled Config file.
- Check system iCloud and in-app sync settings.
- Keep the original data; do not delete subscriptions or reset the app first.
New iPhone
- Check the Apple Account used for iCloud.
- First see what data actually appears, then decide what needs to be imported.
- Check Home and Config to avoid adding the same subscription twice.
- Finish testing the connection before changing automatic connection settings.
Sync keeps data available across devices; a separate copy is for recovery. Do not test sync by deleting or editing the same Config file on both devices at once.
There is no guaranteed sync time. If a file has not appeared on the new phone, make sure both devices have a stable network connection, then reopen the app and check again. Avoid repeatedly toggling iCloud Drive or importing the same file, as this makes it harder to tell where data came from. If you need to get connected right away, use the saved file copy, then check for duplicate content after sync.
New iPhone: Restore Home first, then enable Config
Choose how to get the app from the download page. The iPhone / iPad version costs $2.99 as a one-time App Store purchase. The developer is Shadow Launch Technology Limited; check the App Store listing for system requirements. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. The iCloud steps in this guide apply to iPhone and should not be treated as migration instructions for other platforms.
-
Check the sync results
After opening Shadowrocket on the new phone, check the servers and groups in Home first, then the file list in Config. Make a list of what is missing rather than importing everything from the old phone again right away.
-
Restore subscription sources
If a subscription did not come back, go to Home, tap “+” in the top-right corner → Type → Subscribe, enter your own subscription URL, save it, and update the subscription. For manually added servers, check the protocol, address, port, and credentials against your original details; copying only the display name is not enough.
-
Import a Config file
If the required file is missing from Config, find the backup in the Files app and share it with Shadowrocket, or use the file import option currently available in Config. Return to Config, check the imported file's contents, and set it as the active Config.
-
Check the routing selection
Go to Home → Global Routing and select the mode you noted on the old phone. To verify the rules in a Config file, select Config and check that the server chosen in each policy group is still available. This helps catch cases where rule names were restored but their actual destinations are missing.
-
Authorize and test
Turn on the connection and follow the system prompt to allow a VPN configuration and complete device authentication. First test a site you know is accessible, then check a destination that requires a proxy. Finally, go to Settings → On Demand and review the automatic connection conditions.
The number of entries after restoring a subscription may change when the provider updates it. A different count alone does not mean the migration failed. Check the subscription source, update result, and whether the servers connect. If you manually changed server fields generated by a subscription, updating it again may overwrite those edits; compare them with your own records.
Verify the restore: Separate rule issues from connection issues
“Server visible,” “connection switched on,” and “rules working” are three different checks. First confirm that an individual server connects, then check Config policies and rules. Enabling complex Scene or On Demand conditions right away can make network changes alter the connection state too, adding variables to troubleshooting.
Config: Verify migrated rules
RecommendedTraffic is handled according to the rules and policies in the active Config file. Check which policy each rule references and which fallback policy FINAL points to. Traffic that does not match an earlier rule does not necessarily connect directly.
Best for: Checking everyday routing after confirming that a server works.
Proxy: Narrow down the issue
Use Proxy as the global routing mode to temporarily check whether the current server connects. This does not confirm that DOMAIN-SUFFIX, GEOIP, or IP-CIDR rules in Config have been restored correctly.
Best for: Telling server connection problems apart from Config rule issues.
Direct: Check the local network
Use Direct as the routing mode to check direct access on the current network. If a destination that requires a proxy is unreachable in Direct mode, that alone does not mean the subscription import failed.
Best for: Checking the local network as a comparison—not proof that proxy access is fully restored.
If the old phone used Scene, also check each associated condition and policy after restoring it. Settings → On Demand manages conditions for on-demand connections; these are separate from Config rules for traffic destinations. Verify a manual connection first, then restore automatic behaviors triggered by conditions such as Wi-Fi or cellular networks.
- Server: Check the protocol, address, port, and credentials. Use the port from your own connection details; do not change it to 443 just because you switched phones.
- Config: Confirm that the imported file you want is active, not another file in the list with the same name or a default file.
- Dependencies: Check whether remote rule resources can update and whether any policy groups in Config refer to servers that are missing.
- System: Confirm VPN permission has been granted and that no other system network setting is repeatedly interrupting a manual connection.
Step-by-step checks for an incomplete restore
Why is Config still empty even though I’m signed in to the same account?
On both iPhones, check Settings → Apple Account → iCloud → iCloud Drive, as well as Shadowrocket → Settings → iCloud. Confirm that the old phone has data to sync, both devices use the same account, and iCloud storage is available. If the data still does not appear, restore Config from a separately exported file. Do not erase the old phone first.
Why are there no servers in Home even though Config has a file?
This usually means the two types of data have different restore coverage. First check whether the Config file actually contains server definitions, then check the subscription sources in Home. If a subscription is missing, use a URL you have saved to add and update it via Home → “+” → Type → Subscribe. Do not expect a rules-only file to recreate all your servers.
There are two files with the same name after import. Which one should I delete?
Open each file and compare its rules, policy groups, and active status; the filename alone does not tell you which is newer. Save a separate copy of the one you have confirmed works, then remove the duplicate you no longer need. If sync is enabled, deleting a file may affect the other device, so make a separate backup before cleaning up.
Why can the subscription update, but the new phone still won’t connect?
In Home, select a server you know works and confirm that VPN permission is granted. Temporarily use Global Routing → Proxy to test the connection, then switch back to Config and check the rules. If the problem occurs only on the new phone, check server-side device limits, subscription status, and the current network. Do not keep deleting all data and starting over.
Why does the connection drop when I switch Wi-Fi networks, even though manual connection works?
Go to Settings → On Demand and review each condition carried over from the old phone to make sure it suits the new environment, especially Wi-Fi SSIDs. Temporarily pause automatic conditions and test a manual connection, then restore the conditions you need. If you use Scene, check its associated settings too; changing Config rules alone may not fix the issue.
After migration: What to keep and what to remove
Test the new phone on both a regular Wi-Fi network and cellular data before you do anything with the old phone. Do more than just open the app: confirm that a server connects, the subscription updates, the intended Config is enabled, and the required On Demand conditions do not cause unexpected reconnects or drops.
- Keep a verified, working copy of the Config file and use a clear filename to distinguish its purpose. Do not overwrite your only copy of the old file.
- Note which data came from iCloud, which was imported from a file, and which you entered manually. This makes it easier to identify what needs restoring next time.
- Remove temporary exports and duplicate subscriptions you no longer need. Do not share files containing passwords, keys, or subscription tokens through public links.
- When preparing to hand off the old phone, follow the system's device transfer process to sign out of accounts and erase the device. Do not start by deleting cloud data item by item in an app that is still syncing.
Get Shadowrocket and complete the initial setup
The iPhone / iPad version is a one-time $2.99 App Store purchase; the Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. Go to the download page for your device. After restoring your data, continue with the first connection and enabling Config.