Shadowrocket VPN Configuration Prompt: What It Means on iPhone and iPad

Learn why iOS asks to add a VPN configuration, where to find it in Settings, and how to add it again if you denied permission or deleted it.

At a glance

The first time you turn on the connection switch in Shadowrocket on an iPhone or iPad, iOS asks for permission to save a VPN configuration. This configuration appears in the system VPN list; it is not an in-app rules file, and you do not need to install a separate configuration profile. If you denied permission or deleted the entry, first check whether Shadowrocket is still listed in Settings, then decide whether to authorize it again or troubleshoot the saved connection.

Why does the first connection require a VPN configuration?

When you turn on the connection switch in Home, Shadowrocket needs iOS or iPadOS to establish and manage a VPN tunnel. If the device does not yet have a VPN configuration for the app, Shadowrocket asks iOS to save one, and iOS asks you to confirm. The English prompt reads Would Like to Add VPN Configurations. Approving it allows the app to add a system VPN configuration; it does not install a certificate, enroll the device in management, or confirm that a remote service is reachable.

Start connectionApprove permissionSave configurationAttempt to establish tunnel

After you tap Allow, the system may require authentication, depending on your device settings. Once authentication is complete, Shadowrocket appears in the VPN list, confirming that iOS saved the configuration. To check whether the connection succeeded, look at the switch and status in Home. The prompt’s reference to network activity means that, when the connection is active, VPN components can handle traffic routed through the tunnel. If you did not just start a connection in the app, cancel the prompt and check the app name shown. Do not identify its source by appearance alone.

Where to find the VPN configuration, and how it differs from a configuration profile

After leaving the app, open your device’s Settings → General → VPN & Device Management → VPN and look for Shadowrocket in the VPN list. Open the VPN submenu to check; the outer page alone can make it easy to mistake device management or configuration profiles for the app’s VPN list.

VPN
System VPN entry and its status
Config
In-app configuration and routing rules
On Demand
Connect automatically when conditions are met

The system VPN entry starts and manages the tunnel. In the app, Config manages configurations and rules—for example, FINAL at the end of a ruleset determines which policy applies when none of the earlier rules match. A configuration profile is a way to deliver settings to the system and can include VPN settings. However, Shadowrocket requests its VPN entry directly from the app when you first connect; you do not need to install a profile first. Deleting the system VPN entry does not delete the app’s Config or its saved service settings.

How to troubleshoot: identify which layer is affected

If Shadowrocket is missing from the VPN list, return to Home and start a connection. If the entry is present and the app shows connected, but only some domains fail to load, note one affected domain and check the current Global Routing setting and its matching rule. Do not delete the system configuration as a first step.

How to add the configuration again after denying permission or deleting it

If you tapped Don’t Allow, canceled authentication, or deleted the entry in Settings, you can usually return to the app and start a connection again. There is no need to enter a server address manually in Settings or reinstall the app just to retry authorization.

  1. Check whether the entry exists. Go to Settings → General → VPN & Device Management → VPN. If Shadowrocket is still listed, note whether it shows as connected or disconnected. If the list also contains a work or school VPN, leave those entries alone; do not delete them by mistake.
  2. Return to Home and connect manually. If the switch still appears on but the status is abnormal, turn it off and wait until it shows disconnected, then turn it on again. If the prompt names the Shadowrocket action you just started, tap Allow and complete any authentication requested by the system.
  3. Check the saved entry and connection status separately. Reopen the system VPN list to confirm the entry is there, then return to Home and check the status. If the entry is present but the switch quickly turns off, troubleshoot tunnel startup or another connection issue instead of repeatedly requesting the same permission.
  4. If you need to recreate the entry, remove only Shadowrocket’s. Disconnect in the app first. If it reconnects on its own, pause automatic connections in Settings → On Demand, then open the system VPN submenu. If the entry’s details offer Delete VPN, confirm the name before deleting it. Then return to Home and start a new connection.

If the entry is missing and manually starting a connection never brings up a prompt, first check whether your device is managed by your employer or school. Management policies may restrict adding VPNs or changing managed configurations. Share the exact system message and the steps that triggered it with your administrator. Do not delete a management profile as a test.

Configuration saved, but connection fails: how to read diagnostic information

The labels below are diagnostic identifiers from Apple’s Network Extension; they are not necessarily prompt titles shown verbatim in Shadowrocket. Use them to guide troubleshooting only when the corresponding identifier appears in diagnostic information. If you only see the connection switch turn off, first note whether the system entry exists, how long the switch stays on, and whether the issue started after changing networks.

NEVPNError.configurationDisabled

Cause: The VPN configuration exists but is not currently enabled. Fix: Return to Home and try connecting manually once. If device policies prevent changes to the configuration, ask your administrator to check; a manual disconnect does not mean you need to reinstall the app.

NEVPNError.configurationInvalid

Cause: The system has determined that the VPN configuration used to start the connection is invalid. Fix: Check the system VPN list first. If the error keeps recurring, the entry is definitely Shadowrocket’s, and deletion is allowed, recreate that entry using the steps above. Do not change other VPN entries.

If the configuration is saved and the connection stays active, but no pages load, disconnect if possible and open the same page on the same network. This checks whether the underlying network is working. If the page loads while disconnected, check the service selected in Home and Global Routing. In Config mode, check which rules are actually taking effect. This helps distinguish network issues, outbound connection issues, and domain-routing issues without deleting the system VPN entry each time.

Common questions about authorization, VPN status icons, and automatic reconnection

I tapped Allow. Will iOS ask again next time?

If the configuration remains on the same device, you generally do not need to approve it again for routine disconnects and reconnects. If a prompt appears every time, complete authentication and then check whether the entry was actually saved in the system VPN list. Check separately on each new device.

Does the VPN icon mean my web traffic is going through a proxy?

The icon alone cannot confirm that. First check which app owns the active connection in the system VPN list, then check Global Routing in Shadowrocket’s Home. With Config, individual requests may be routed directly or sent through a proxy according to the rules; the icon cannot confirm the route taken by a specific domain.

Why did the connection come back after I turned it off and switched Wi-Fi?

In Shadowrocket, check Settings → On Demand to see whether automatic connection is enabled for certain conditions. For troubleshooting, pause it, disconnect from Home, then repeat the same network switch. If a different VPN reconnects, check that connection’s settings rather than changing Shadowrocket’s routing rules.

Do I need to import my existing subscription again before deleting the VPN entry?

No. After deleting only Shadowrocket’s system VPN entry, return to Home and check that your existing service entry is still there, then turn on the connection switch to authorize it again. Restore settings from a source you control only if the corresponding in-app entry is actually missing. Do not share full subscription URLs or access credentials while troubleshooting.

Download Shadowrocket