Moving Shadowrocket to a new iPhone involves four separate items: the app, your Config file, connection details in Home, and system VPN permissions. This guide is for users who can still access their old iPhone. Check iCloud sync first, export a separate copy of your config, then restore and verify each item on the new phone. Don’t assume the migration is complete just because the app is installed or a file is in the cloud.
1. Understand the difference between Config files, subscriptions, and device settings
Before switching phones, open Shadowrocket on the old device and confirm your current connection works. Note the connection selected in Home, the current Global Routing option, and the filename in use under Config. This guide assumes you already have your own service provider and subscription. This site does not provide, sell, or recommend nodes or subscriptions.
A Config file can contain rules, DNS, policies, and other settings; it may also include connection details, depending on the file. Don’t assume that exporting one Config file backs up every connection in Home, subscription URL, or toggle in Settings.
| What to migrate | What to keep on the old phone | What to check on the new phone |
|---|---|---|
| Config file | The file currently in use and any external rule URLs it references | The file opens, and rule and policy names match |
| Home connections and subscriptions | Existing subscription URLs and complete details for manually added connections | Groups, connection entries, and update results match expectations |
| Global Routing | Current option and intended use | Make sure you haven’t restored only the file while leaving a different routing mode selected |
| Settings and system permissions | Required toggles and network conditions | Grant VPN permission and check On Demand again |
Bottom line: Export a separate copy before switching phones
If the old phone, cloud copy, and new phone all point to the same data, an accidental deletion could sync across all of them. Save a separate copy of the working config first and confirm it opens before changing sync settings or clearing the old device.
2. Check what syncs before enabling iCloud
iCloud sync, saving files to iCloud Drive, and a full-device iCloud backup are different things. A device backup is for restoring a device; saving a Config file to iCloud Drive gives you a file you can import manually; in-app sync depends on what the installed version currently supports. A completed device backup does not necessarily mean every subscription URL has synced.
- On the old phone, open Settings, tap your Apple Account at the top, then go to iCloud. Confirm you’re signed in with the account you’ll use on the new phone, and check that you have enough storage.
- Go to iCloud Drive and make sure “Sync this iPhone” is enabled. System menu names may change with iOS updates; follow the labels shown on your device.
- Find Shadowrocket in the list of apps using iCloud. If a relevant toggle appears, allow it to use iCloud. Then return to Settings in Shadowrocket. If the installed version offers an iCloud sync option, enable it as instructed and check which items sync.
- Save the exported Config file in a separate folder in iCloud Drive. Open the Files app, wait for the upload to finish, and confirm you can open the file again.
- On the new phone, signed in to the same iCloud account, check that the file is visible and can be downloaded. Seeing the filename without being able to read the file does not count as a successful check.
3. Export a Config file you can restore
Before exporting, make sure you’ve selected the Config file you actually use, not an older file with a similar name. If you use a remote config, keep both a working local copy and its original source details. The remote URL may change, and saving the URL alone won’t preserve its current contents.
- Go to Config in Shadowrocket and note the filename currently in use. Open the file and confirm it contains the rules that are running, rather than being blank or a default file.
- Open the action menu for the config you want to export and use the sharing or export option available in the current interface. You can also try long-pressing the file to see available actions. Button locations vary by version, so follow the menu shown on your device.
- In the system share sheet, choose “Save to Files” and save the complete config file. Don’t just copy the filename, preview text, or config source URL.
- Use a name that’s easy to recognize, such as
phone-migration.conf. If the file already has an extension, keep it so the file type is preserved and it isn’t saved as a text document containing only a preview. - Reopen the saved copy from the Files app and check that the beginning, end, and rule sections are intact. Then keep another copy that doesn’t rely on this sync process.
Use the snippet below to recognize the structure when checking rules. It’s an example for reference, not a migration file to replace your existing config. Preserve the original rule order, policy names, and required parameters when migrating.
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches IP ranges, GEOIP uses IP geolocation, and FINAL handles requests that didn’t match earlier rules. If the original file uses custom policy groups, keep their definitions too; copying only the rule lines won’t be enough.
4. Redownload Shadowrocket and restore your data on the new iPhone
Your app purchase history and config data are separate. The Apple Account used for App Store Media & Purchases may differ from the one used for iCloud: the first determines whether you can find your purchase, and the second controls access to cloud files. Check both before restoring. Reimporting a config won’t fix a store account issue.
- On the new phone, open your App Store account page and find “Purchased” or the equivalent app purchase list for your version of iOS. Redownload Shadowrocket using the account that originally purchased it. If it’s not listed, first check the purchase account and history.
- Confirm the product name is Shadowrocket, the developer is Shadow Launch Technology Limited, and the app ID is
932747118. See the download page for platform options. - Open the Files app on the new phone and download the saved Config file. Share it with Shadowrocket using the system share sheet. If Shadowrocket isn’t listed, go to Config and use the file import option available in your version to select the same file.
- Open the imported file under Config and check its contents, then set it as the active config. Seeing its name in the file list doesn’t mean it’s in use.
- Check Home. If your existing subscription didn’t come back after restoring, reimport the original subscription URL you saved and run an update once. Don’t repeatedly add the same URL.
There are two ways to get Shadowrocket, depending on the platform: iPhone and iPad are available on the App Store for a one-time $2.99 purchase; system requirements are listed on the App Store page. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. This guide covers moving to a new iPhone; the download page lists options for other devices too.
5. Check connection details, routing mode, and On Demand
Restore manual connections before setting up automatic connections. The first time you enable Shadowrocket on a new phone, read the prompt and grant VPN permission on that device if requested. Approval on the old phone doesn’t grant permission on the new one. First, connect using the manual toggle and test access; then restore your automatic connection conditions.
- Connection details: Check the protocol, server, port, and authentication details for each manually added connection. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different parameter formats. A matching display name alone doesn’t mean the connection has been fully restored.
- Ports and protocols: If the original config uses port
443, use the same value on the new phone. However,443isn’t a fixed port for every protocol, and it must not replace the actual value provided by your service provider. - Global Routing:
Proxy,Direct,Config, andSceneare different options. To handle requests according to your config rules, check thatConfigis selected. Don’t use results whileDirectis selected to judge whether the proxy connection works. - Scene: If the old phone used
Scene, check its conditions and selected policy too, especially whether the new phone’s current Wi-Fi matches the old conditions. - On Demand: Go to
Settings → On Demandand check the saved conditions, then check the VPN configuration status in system Settings. Verify both the app settings and system status; checking just one toggle isn’t enough.
Change one variable at a time when testing. Keep the same network, connection entry, and Config file until access works, then try cellular data. If you change networks, update subscriptions, and edit rules all at once, it’s hard to tell what caused the difference.
6. Common issues after switching phones
Shadowrocket is installed on the new phone, but why is Home empty?
Redownloading the app doesn’t necessarily restore connection details. First check whether you’ve restored your data. Then import and update using the original subscription URL you saved. For manually configured connections, use your backup to restore each parameter. A Config filename isn’t a subscription URL.
The file is in iCloud. Why can’t I import it on the new phone?
First, download and open it in the Files app. Make sure it isn’t just a cloud placeholder that hasn’t been downloaded, a web page, or an error message. Then check its extension and confirm the contents are the original config. If it’s incomplete, export it again from the old phone; don’t overwrite the copy that still works.
The Config file is imported. Why is traffic being handled differently?
First, confirm the imported file is set as the active config, then check Global Routing in Home. If Proxy or Direct is selected, you can’t use that to verify how the original per-rule routing worked. Restore Config for its original use or check the Scene conditions again.
The subscription is back, but some connections disappeared after updating. What should I do?
Compare the old phone’s entries to tell subscriptions apart from manual connections. A subscription update reflects the provider’s current content; it doesn’t restore a historical snapshot. Manually added connections must be migrated separately. Keep the old phone and exported copy, then check whether duplicate entries were consolidated or the remote content changed.
Can I recover my settings after erasing my old phone?
Check, in order, for an exported file in iCloud Drive, sync data actually available to the app, and any device backup you kept. If you only have a subscription URL, you can retrieve the connections currently provided by that subscription. Local custom rules and manual settings that weren’t backed up may not be recoverable.
7. Verify everything before signing out or erasing the old device
The migration is complete when the new phone works as expected on the network you actually use, not when it has the same number of files as the old one. Run the checks below before resetting the old device. Keep it available for a short observation period so you can compare rules, connection details, and automatic triggers.
- The active file under Config is correct, external rules load, and custom policy groups have no missing references.
- Subscriptions in Home update successfully; manually added connections have the same authentication details as on the old phone; and no duplicate groups were created by repeated imports while troubleshooting.
- Global Routing matches its original purpose, and manual connect, disconnect, and reconnect all work as expected.
- Test access on your usual Wi-Fi and cellular networks. If On Demand is enabled, also check what happens when the network changes.
- Keep at least one separate config copy that you’ve confirmed can be read, and store your subscription source and required authentication details securely.
Get Shadowrocket and learn how to restore your setup
Shadowrocket for iPhone and iPad is available on the App Store for a one-time $2.99 purchase; system requirements are listed on the App Store page. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Visit the download page to choose your device, or continue with the guide to check your Config, subscriptions, and connection settings.