When Shadowrocket first connects, iOS may ask permission to add a VPN configuration. This grants permission to create a system VPN entry; it does not import a subscription or install a device management profile. For iPhone and iPad users, this guide covers how to verify the prompt, allow the configuration, check the VPN entry, and resolve common issues. See the all-platform download page for Mac, Windows, Android, and Linux instructions.
Add a VPN Configuration: Allow a System Connection Entry
In short: If the prompt appears after you open Shadowrocket and turn on the connection switch in Home, and it names Shadowrocket as the requesting app, you can allow it if you choose. iOS may then ask for your device passcode or another form of authentication. Follow the system prompts; never enter your device passcode on a subscription page or service provider’s website.
This permission lets the app use Apple’s Network Extension framework to create a VPN tunnel and register its configuration in the system VPN list. The system warning that network activity may be filtered or monitored describes what this permission can do. It does not mean all website content will be decrypted, nor does it confirm that a remote server is connected. The connection destination depends on the app configuration and selected server.
Treat these steps separately: seeing the prompt means the app is requesting permission to add a configuration; allowing it creates a system entry; seeing Connected means the tunnel has entered a connected state. To confirm website access, also check the server, DNS, and rules. Authorization alone does not prove that everything is working.
Prompt text: “Shadowrocket” Would Like to Add VPN Configurations
Why it appears: On an English-language device, this prompt means the app is requesting permission to add a VPN configuration. It is not a connection error. Other system languages show a localized version.
What to do: If you initiated the request in Shadowrocket, select Allow. If you selected Don’t Allow, return to Home and try connecting again to trigger the authorization prompt.
System VPN Entries, Config, and Management Profiles
“VPN configuration” and “profile” are often confused, but they refer to different things. Config in Shadowrocket manages traffic-routing settings; a system VPN entry registers the tunnel connection; a device management profile may contain multiple settings issued by an organization. These are not interchangeable.
| Item | Where to find it | What it does |
|---|---|---|
| System VPN entry | Settings → General → VPN & Device Management → VPN | Records a VPN connection created by an app or configured another way, and shows its connection status and available management options. |
| In-app Config | Shadowrocket → Config | Manages settings such as rules and DNS; it does not grant system connection authorization. |
| Servers and subscriptions | Shadowrocket → Home | Stores server settings and imported subscription content. Get these details from your service provider. |
| Device management profile | The relevant section of Settings → General → VPN & Device Management | May contain organization management, certificates, or network settings. Ordinary VPN authorization does not grant device management access. |
Menu names and locations may vary by iOS version and management status. You can also search for VPN at the top of Settings, then open the connection list. Some devices show a more direct VPN option. Not seeing a separate “Profiles” item does not mean Shadowrocket lacks VPN permission.
How to tell: Identify which layer you need to change
If the system connection entry is missing, check authorization. If website routing is not as expected, check Config and Global Routing. If the server list is empty, check the imported subscription. Do not delete data from other layers while trying to fix one issue.
First-Time Authorization: From Home to System Settings
These steps assume you already have valid server details. VPN authorization does not provide a server or subscription. If Home has no usable entries, get the required details from your service provider first, then import them and test the connection.
-
Check your server
Open Shadowrocket → Home, confirm your server appears in the list, and select the one you want to use. A server appearing in the list is separate from a system VPN configuration being present.
-
Start a connection
Turn on the connection switch in Home. If there is no usable app VPN configuration in iOS yet, the system will ask to add one. Confirm the app name in the prompt, then allow it.
-
Complete authentication
Complete the device authentication requested by iOS. Do this in the system interface. If you cancel midway, return to Home, check the current status, and decide whether to try again.
-
Check the VPN entry
Go to Settings → General → VPN & Device Management → VPN and check for a Shadowrocket entry. Then return to the app and check the connection status.
-
Test access
Use Connectivity Test in Home, then open a website you know should be accessible. Note the test result separately from website access; a system entry does not guarantee the remote service is available.
If the authorization prompt does not appear again but the VPN list already has the correct entry and the connection works, you usually do not need to delete the configuration just to see the prompt again. Existing authorization can be reused; the prompt does not need to appear every time you open the app or connect.
Denied Permission or Missing Entry: Trigger Authorization Again
If you tapped Don’t Allow, try connecting again in the app before uninstalling it. Removing the app can make it harder to restore local settings and is usually not the first step when troubleshooting system authorization. VPN authorization is not a privacy permission like Photos or Microphone, so do not look for a switch on those privacy settings pages.
- Just denied the request: Return to Shadowrocket → Home, make sure the connection switch is off, then turn it on again. If the system prompt appears, allow the configuration and complete authentication.
- The prompt no longer appears: Check the system VPN list first. If an entry is already there, the app may continue using that configuration without asking again.
- The entry is definitely missing: Keep the app in the foreground and try connecting again. If nothing changes, close and reopen the app, then restart the device if needed. Check whether the authorization prompt appears.
- The device is managed by an organization: Check whether it is managed by your school or company. Repeatedly toggling the connection will not bypass a policy that restricts VPN creation; ask your device administrator to check the permissions.
Reauthorizing only addresses whether the system can establish a tunnel. It will not fix an expired subscription, incorrect port, or remote service outage. If authorization succeeded and an entry appears but the connection still fails, check the server settings instead of repeatedly deleting and recreating the same VPN configuration.
Duplicate Entries and Automatic Reconnection: Stop First, Then Clean Up
If the VPN list contains several similar names, do not decide what to delete based on the name alone. Entries from different apps, manual configurations, and organization management can all appear in the same list. Check each entry’s details and associated app first. If you cannot identify its source, leave it in place.
- In Shadowrocket → Settings → On Demand, check the on-demand connection settings. Temporarily turn off On Demand while troubleshooting so its conditions do not trigger a connection during cleanup.
- Return to Home, turn off the connection switch, then check the system VPN status to confirm the connection has ended.
- Go to Settings → General → VPN & Device Management → VPN. Open the details for the entry you have confirmed belongs to Shadowrocket and want to remove. You can usually do this using the info button on the right.
- Choose “Delete VPN” only if you can confirm the entry is obsolete or duplicated. Do not also delete device management profiles, certificates, or connections used for other purposes.
- Return to Shadowrocket and connect again. Reauthorize if prompted, then check the system list. Once manual connection and disconnection work as expected, restore any On Demand conditions you need.
On Demand triggers a connection when its configured conditions are met. It does not refresh subscriptions on a schedule or set the routing mode in Global Routing. If the connection drops and immediately comes back, check the On Demand conditions and the on-demand option for that system entry. The options shown depend on your device.
Deleting a system VPN entry is different from deleting a server in Home or a file in Config. Change only the layer you need to troubleshoot, and check the result after each change so you can tell what restored the connection. Ask an administrator to handle entries marked as managed by an organization or that cannot be removed.
Authorized but No Internet Access: Troubleshoot by Layer
If the system has a Shadowrocket entry and the app can start the tunnel, focus on the actual data connection. Successful authorization does not verify server credentials, TLS settings, or subscription contents, and it does not choose suitable routing rules for you.
| What you see | Check first | Next step |
|---|---|---|
| No system entry; first connection was canceled | VPN configuration authorization | Return to Home, try connecting again, and allow the request and complete authentication. |
| Entry exists, but the connection drops soon after connecting | Server settings and network reachability | Check the selected server, address, port, and authentication details, then ask your service provider to confirm the service is available. |
| Connected, but some websites fail | Global Routing, Config, and DNS | Note the domains that fail and check the routing strategy in use. Do not keep recreating the system VPN entry. |
| Connection resumes automatically after manual disconnection | On Demand and management policies | Temporarily turn off on-demand connection and monitor the result. On managed devices, also check the organization’s policies. |
In Home → Global Routing, Config uses its rules to determine where traffic goes; Proxy and Direct select proxy and direct routing, respectively. Changing the mode changes the access path, but does not grant system authorization. To compare results, change only one setting at a time, retest the same website on the same network, then restore your usual configuration.
For example, an HTTPS service using port 443 does not mean every server port should be changed to 443. Use the settings provided by your service provider for each server. Connectivity Test can help diagnose a connection, but one successful test does not mean every domain, rule, or app’s traffic is working.
Common Questions: Permission Scope and Recovery
Does allowing a VPN configuration give the app control of my entire device?
This authorization alone does not grant device management privileges. It allows a VPN configuration to be created and used, so related traffic may pass through the app’s tunnel. Device management profiles are separate and can be checked in Settings → VPN & Device Management.
Why is there no server in Home when Shadowrocket appears in Settings?
The system entry stores VPN connection settings; it does not provide a server list. Get your server details from your service provider, then import them in Home. Deleting the system entry will not restore subscription content.
Do I need to buy the app again after deleting a VPN entry?
Deleting a system VPN entry does not cancel your app purchase. The iPhone and iPad version is a one-time $2.99 purchase from the App Store. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Keep your in-app data, then start a connection from Home and authorize it again.
What information should I provide when asking for help?
Note the exact system prompt, the steps that triggered it, whether an entry appears in the VPN list, the connection status in Home, and whether On Demand is enabled. Before sharing screenshots, hide server addresses, account details, passwords, subscription credentials, and other sensitive information. Never share your device passcode.
Shadowrocket: Getting the App and Connecting for the First Time
The iPhone and iPad version is a one-time $2.99 purchase from the App Store. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Check the App Store listing for iPhone and iPad system requirements. The developer is Shadow Launch Technology Limited. Choose your platform on the download page, or follow the complete guide from importing a configuration to testing the connection.