· Troubleshooting · About 8 min read

Shadowrocket: Add VPN Configuration Prompt Explained

Learn why Shadowrocket requests VPN permission on first connection, how it relates to the VPN entry in Settings, and how to remove and recreate a broken configuration.

At a glance

This guide is for iPhone and iPad users connecting Shadowrocket for the first time, or troubleshooting repeated permission prompts or a connection switch that turns off immediately. First, check for a Shadowrocket entry in the system VPN list. Then decide whether to recreate the device’s VPN configuration or keep it and troubleshoot routing or the existing service connection.

Why does the first connection require permission?

When you turn on the connection switch in Shadowrocket’s Home, the app asks iOS or iPadOS to save a system VPN configuration if one isn’t already available. This is a system permission prompt. It asks whether the app can add the configuration—not whether you want to buy a service, import a subscription, or connect to a particular address. Check that the app named in the prompt is Shadowrocket and that the prompt appeared right after you turned on the connection switch. If you didn’t initiate the request, cancel it and check which app triggered it.

Connection requestSystem permissionConfiguration savedTunnel startsTraffic is routed

After you allow the request, the system may ask for your device passcode or other authentication to save the configuration. Enter credentials only in the system authentication screen—never enter your device passcode in Add Server. Saving the configuration and starting the tunnel are separate steps: a Shadowrocket entry in system settings means the configuration was saved, but you still need to check whether the connection stays active and whether webpages load. If you denied the request the first time, return to Home and turn on the connection switch again. You don’t need to delete the app or reimport your existing configuration.

VPN entries, management profiles, and in-app configuration

On your device, go to Settings → General → VPN & Device Management → VPN, find the entry for Shadowrocket, and check its connection status and details. Menu labels may vary slightly by iOS version. You can also search for VPN in Settings and open the VPN list. Check the VPN connection entry here—not just any profile listed under VPN & Device Management.

  • System VPN entry: Saves the system settings Shadowrocket needs to start its VPN. The entry can remain after you disconnect, so seeing it in the list doesn’t mean you’re currently connected.
  • Device management profile: A school or workplace may use device management to deploy VPN settings. This is a different type of managed item from an entry the app requests permission to add. If an entry is marked as managed or has no delete option, check with your device administrator. Don’t remove the entire management profile.
  • In-app configuration: Existing service entries in Home and rule files in Config specify connection parameters and how traffic is handled. Deleting Shadowrocket’s VPN entry in system settings usually leaves this in-app data untouched. There’s no need to uninstall the app.

A VPN status of Connected in system settings only indicates that the tunnel has started. Shadowrocket’s Global Routing setting also determines how traffic is handled: Direct sends traffic out without a proxy, while Config routes traffic according to the selected configuration’s rules. So VPN status alone can’t tell you whether a particular website is using a proxy.

Determine whether the configuration is broken or the connection is failing

Reproduce the issue without changing your Wi‑Fi or cellular network, service entry, or rule file. Start a connection from Home and note whether the switch turns off immediately, whether a Shadowrocket entry appears in the system VPN list, and whether the error occurs before permission is granted or after you connect. Use the symptoms below to decide what to check next.

What you seeWhat to check next
No entry appears after you allow accessCheck whether system authentication was completed. If the device is managed, ask your administrator whether apps are allowed to add VPN configurations.
An entry exists, but the switch turns off immediatelyCheck whether another VPN is connecting or Settings → On Demand is interfering with your manual test. If neither applies, consider recreating the entry added by the app.
The connection stays active, but some websites failKeep the system entry and check Global Routing first. If you’re using Config, check the selected file and the rule for the affected domain in Config.

Error: The VPN server did not respond.

What it means: This system message means the connection attempt received no response from the server. It doesn’t mean VPN permission has expired.

What to do: Disconnect the VPN and make sure you can browse the web on your current network. Then keep your in-app configuration unchanged and test again on another known-working network. If it still fails, check that the address and port in your existing service entry match the original configuration.

Bottom line: Test changes against the same destination

Choose a website that loads normally when the VPN is disconnected. Change one setting at a time and test the same website after each change. If the system connection status stays the same but the website result changes, note the current routing mode and investigate traffic handling instead of repeatedly deleting the system entry.

Remove and re-add the Shadowrocket VPN configuration

These steps recreate only the VPN entry that Shadowrocket added on your iPhone or iPad. Use them after confirming which app owns the entry, checking that device management doesn’t restrict changes, and confirming that repeated connection attempts still fail. If a work VPN is active, check whether it can be interrupted before proceeding. Don’t disconnect or delete it to troubleshoot Shadowrocket.

  1. Note your current settings

    In Home, note the selected service entry and Global Routing mode. If you use Config, also note the current rule file name. Record names only—don’t copy passwords or links containing tokens into your troubleshooting notes.

  2. Turn off automatic connections

    If enabled, pause on-demand connections in the app under Settings → On Demand, then return to Home and turn off the connection switch. This helps distinguish manual connection requests from automatic reconnections during troubleshooting.

  3. Delete the specific entry

    Go to Settings → General → VPN & Device Management → VPN, tap ⓘ next to the Shadowrocket entry, choose Delete VPN, and confirm. If you can’t identify the entry or there’s no delete option, stop here. Don’t delete neighboring entries or a device management profile.

  4. Grant permission again

    Return to Shadowrocket’s Home and turn on the connection switch. When the system asks to add a VPN configuration, check the app name, allow the request, and complete any required authentication. Don’t manually create a different type of connection in system VPN settings to replace the app’s entry.

  5. Verify, then restore your settings

    Return to the system VPN list and confirm that the Shadowrocket entry has reappeared. Check whether the connection stays active, keeping your existing routing and in-app configuration unchanged, and test against the same destination. Once the manual connection is stable, re-enable On Demand if you had it on, then test separately that it triggers as expected.

Repeated permission prompts and connection issues

Why does the permission prompt keep appearing after I tap Allow?

After completing system authentication, go straight to Settings → General → VPN & Device Management → VPN and check for the entry. If it’s missing, check whether authentication was canceled or the device is managed. If the entry is present, note the full prompt text and confirm whether it’s asking to add a configuration again or reporting a connection error.

The VPN reconnects after I turn it off. Should I delete the configuration?

Not yet. Pause on-demand connections under Settings → On Demand, disconnect from Home, and observe what happens on the same network. If a different managed VPN connects automatically, check its name in the system list and contact your device administrator.

Do I need to grant permission again when I switch service entries?

Usually not. Service entries are stored in the app; switching entries and recreating the system VPN configuration are separate things. If the connection fails after switching, first switch back to the entry that worked and compare results on the same network and routing mode.

I deleted the VPN entry, but turning the switch back on shows no prompt and doesn’t connect. What should I do?

Refresh the system VPN list to confirm that the original entry is gone, then return to Home and try connecting again. If the entry is still missing and no permission prompt appears, note the system message and whether the device is managed. On a managed device, ask your administrator whether apps can add VPN configurations. Don’t use Reset Network Settings as a substitute for troubleshooting.

Download Shadowrocket