This guide is for first-time Shadowrocket users on iPhone or iPad, and for anyone who denied the request or accidentally deleted the system VPN configuration. Adding a VPN configuration authorizes the app to create a system network tunnel. It does not import a server or install a device management profile. First, make sure the prompt appeared after you turned on Shadowrocket. Then allow the request and complete system verification. Finally, check the system configuration, the server in the app, and the connection status separately.
1. What does adding a VPN configuration allow?
After you turn on the connection switch in Home, iOS or iPadOS displays a request to add a VPN configuration if no usable Shadowrocket configuration is saved. Allowing it lets the app create a network tunnel using the system's VPN mechanism. The prompt mentions network traffic because eligible traffic is routed through this connection while it is active. How that traffic is ultimately handled also depends on Global Routing, the current Config, and your server settings.
A “VPN configuration” is a connection setting saved by the system. It is not a rules file in Config or a server list imported through Subscribe. Allowing the request does not add a working server or provide a service plan, and it does not by itself guarantee that a website will load. A one-time app purchase does not include a service plan. If you need a subscription, get it from your service provider.
VPN configurations vs. device management profiles
VPN configuration
- The app asks the system to add it so the system can establish the corresponding VPN connection.
- View its connection status and details in the system VPN list.
- If deleted, it may need to be added again the next time the app connects.
Device management profile
- May include organizational management, restrictions, or other system settings.
- It appears in a nearby area of Settings, but it is a separate item from the VPN configuration.
- When troubleshooting Shadowrocket, do not also remove organization management settings.
“VPN & Device Management” is the name of a Settings page. Adding a Shadowrocket VPN configuration does not enroll your device in organizational management.
2. Authorize the first connection
Before you begin, import your server details and make sure the prompt appears after you turn on the connection switch in Shadowrocket. The iPhone and iPad version is available on the App Store for a one-time purchase of $2.99; the developer is Shadow Launch Technology Limited. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. For iPhone and iPad system requirements, refer to the App Store listing. See the download page for all platforms. The Settings path below applies to iPhone and iPad.
-
Check your server
Open Shadowrocket → Home and make sure the server you want to use has been added and selected. To use a subscription, tap “+” in the upper-right corner of Home → Type → Subscribe, enter the link provided by your service provider, save it, and refresh the server list.
-
Turn on the connection
Return to Home and turn on the connection switch at the top. If the system asks to add a VPN configuration, check the app name in the request. Do not mistake a request initiated by another app for this authorization.
-
Allow and verify
Allow the request, then follow the system prompts to verify with your device passcode or other identity check. The available method depends on your device. Enter the device credentials requested by the system, not a server password or subscription token.
-
Check the connection
Return to Home to check the connection status, then open the system VPN page to confirm the corresponding entry. Test the site you need to access. A saved configuration, an active tunnel, and access to a specific destination are three separate checks.
3. Find the VPN configuration in Settings
On your iPhone or iPad, open Settings → General → VPN & Device Management → VPN. The exact labels may vary by OS version, language, or device management status. If you don't see the option where expected, search for VPN in Settings. In the list, find the entry associated with Shadowrocket and tap its information button to view the details. Don't identify it based only on its position in the list.
Check in Settings
- Path
- Settings → General → VPN & Device Management → VPN
- What to look for
- The VPN entry associated with Shadowrocket
- Check
- Connection status, entry name, and details
- Where to delete it
- The entry's information page → Delete VPN
Only change a VPN entry after confirming which app it belongs to. Check with your administrator separately before changing any organization management settings.
Check in the app
- Home
- Selected server and connection switch
- Config
- Current Config and rules
- Global Routing
- Current routing mode
- Settings → On Demand
- Whether automatic connection conditions are configured
A system entry confirms only that the configuration is saved; it does not replace checking the settings in the app.
The VPN icon in the system status bar can be a useful clue, but it may look different across devices and situations. Check both the system VPN page and the status shown in the app. The icon being temporarily absent does not necessarily mean the configuration was deleted, and “Connected” does not confirm that every server setting and rule is correct.
4. Re-add the configuration if it was deleted
If you deleted only the corresponding entry from the system VPN details, return to Shadowrocket first and check whether your original data is still there. The system VPN configuration and the data in the app are separate; deleting the former usually does not clear Home or Config. However, check what is actually still on your device. You don't need to buy the app again to restore authorization, and reauthorizing will not restore local data that has been erased.
-
Keep your existing data
Check that the server is still listed in Home and the current Config is still available. If anything is missing, restore it from your own backup first. Get your subscription link from your service provider again if needed; deleting a VPN configuration does not restore servers.
-
Pause automatic connections
Go to Settings → On Demand and check your existing automatic connection settings. Temporarily disable them so you can observe the results of manual actions. If the system VPN details also show an “On Demand” switch, check its status too.
-
Trigger a new request
Return to Home, turn the connection switch off, then turn it on again. When the system asks to add a configuration, allow it and follow the verification prompts. Then check the system VPN list to confirm that the entry was added again.
-
Restore your connection settings
First, test a manual connection and access to your intended destination. Then re-enable On Demand if needed. Change one condition at a time to avoid automatic reconnections obscuring the results of turning the connection off or reauthorizing.
If no request appears after toggling the switch, first check whether the corresponding configuration already exists in Settings. Then close and reopen the app and try again. Organization-managed devices may prevent users from creating VPN configurations. If you see a restriction message, contact your device administrator; do not try to bypass it by removing the management profile.
5. Troubleshoot connection and access issues
The add request only handles system authorization. If the connection drops, a test times out, or a website won't load afterward, troubleshoot three layers: the system connection, server settings, and rule routing. Repeatedly deleting the VPN configuration won't fix a server port, authentication details, or routing rules—and means you have to go through authorization again for each test.
- No corresponding system entry: Complete the add request and device verification first. If a system policy blocks the request, note the full message and address the permission restriction rather than changing the protocol.
- Entry exists, but the connection fails: In Home, check the selected server and the Connectivity Test result. Compare the address, port, and authentication details against the information from your service provider. For example, if they specify port 443, don't change it to 8443. The same port does not mean the protocol and transport settings are the same.
- Some sites or services fail after connecting: Check Global Routing. Proxy and Direct select different routing behavior; Config applies rules from the current configuration, and Scene relates to scene settings. Before troubleshooting rules, make sure the intended routing mode is active.
- Only rule-based routing behaves unexpectedly: In Config, check which file is active. DOMAIN-SUFFIX, IP-CIDR, and GEOIP are different match conditions. Rules are evaluated in order, and FINAL provides a fallback at the end. Editing rules and re-adding the system VPN configuration are separate tasks.
6. FAQs about adding a VPN configuration
Why does it reconnect after I turn it off?
First check Settings → On Demand, then check the “On Demand” status in the system VPN details. If automatic connection conditions are set, they may trigger a new connection when met. Temporarily disable automatic connection, turn the connection off manually from Home, and observe the result. Restore the conditions you need afterward.
Do I need to install a certificate to add a VPN configuration?
Adding a system VPN configuration and installing a certificate are separate actions. You do not need to install an extra root certificate to approve this prompt. Some server protocols use TLS; configure certificate verification according to the details from your service provider. This does not mean you need to install and trust a new root certificate in the system.
If I delete the VPN configuration, do I have to buy my subscription again?
Deleting a system VPN configuration does not change your account or plan with your service provider. First check in Home whether your server list is still there. To restore a subscription, get the link from your service provider and import it again. App purchase, system authorization, and your provider's service are separate things.
There are several VPN entries in Settings. Which one should I delete?
Turn off the current connection first, then check the name, associated app, and details of each entry. Only change entries you can confirm belong to Shadowrocket. Having multiple entries does not mean they are all in use. If the device belongs to your workplace or school and you can't confirm ownership, ask the administrator. Don't start by deleting everything.