· Troubleshooting · About 7 min

Shadowrocket VPN Configuration Prompt: How to Manage VPN Permissions on iPhone and iPad

When you first turn on the connection switch, iOS asks to add a VPN configuration. Learn where to find it in Settings, what Allow or Don’t Allow does, and how to remove or authorize it again.

At a glance

Choose Allow only when you’ve just started a connection from Shadowrocket’s Home screen and the prompt identifies Shadowrocket as the app requesting the configuration. If you tapped Don’t Allow by mistake, return to Home and try again. If authorization is already granted but you still can’t connect, check the entry and connection status in the system VPN list before deciding whether to authorize again or troubleshoot the existing connection.

What does the system authorize when adding a VPN configuration?

This is an iPhone or iPad system confirmation, not a prompt to import a node into Shadowrocket. The app needs to save a VPN configuration in iOS so it can use the system’s VPN functionality when you connect. The prompt’s notice about network activity appears because traffic routed through the tunnel is handled according to its configuration. Check which app is making the request before confirming. If you didn’t start a connection or the prompt doesn’t name Shadowrocket, choose Don’t Allow.

2 items
System prompt: Allow / Don’t Allow
4 steps
Check: Settings → General → VPN & Device Management → VPN
2 places
Check entries and status in system VPN settings; start connections from the app’s Home screen

Bottom line: Check the system VPN entry to tell authorization issues from connection problems

If there’s no Shadowrocket entry, return to Home and retry authorization. If the entry already exists, don’t wait for the prompt to appear again. First check whether a connection can be established and whether it drops afterward.

“VPN configuration” here means the connection entry in the system VPN list. It does not mean you need to install a separate device management profile. The app configuration selected on Shadowrocket’s Config tab is a different item; changing its rules does not replace system authorization.

What to do the first time—or after tapping Don’t Allow

  1. Start a connection

    Open Shadowrocket and go to Home. If you want to connect through a proxy, select a node you’ve already added, then turn on the connection switch at the top. When the prompt appears, you can confirm it matches the action you just started.

  2. Check and confirm

    Check that the system prompt identifies Shadowrocket as the app requesting to add a VPN configuration. Tap Allow if you want to proceed. If iOS then asks for your device passcode, follow the on-screen instructions. Until you confirm, don’t treat a failed connection as a node issue.

  3. Retry after denying

    If you tapped Don’t Allow by mistake, this request won’t create a configuration. Return to Home, wait for the connection attempt to finish, then turn on the connection switch again. If no prompt appears, first check for an existing entry in the system VPN list rather than manually entering a new server address in Settings.

  4. Check the connection status

    Go to Settings → General → VPN & Device Management → VPN and check the status of the Shadowrocket entry. An entry in the list with a Disconnected status means the system has saved the configuration; it doesn’t mean the tunnel is currently running.

On devices set to another language, system menus and confirmation buttons appear in that language. If you can’t find the path above, search for VPN in system Settings and open the page showing saved connections. Don’t confuse system Settings with the Settings tab inside Shadowrocket.

Remove the system VPN configuration and authorize again

To temporarily stop the connection, disconnect and leave the configuration in place. Remove Shadowrocket’s system entry only if you need to, or if you want to check whether iOS can create it again. Removing the system VPN configuration does not clear nodes or rules from the app. After recreating it, check the system entry, selected node, and app configuration separately.

  1. Open Shadowrocket and go to Home, then turn off the connection switch. If you enabled automatic connections, temporarily turn off the relevant setting under Settings → On Demand so the connection doesn’t start again as soon as you disconnect.
  2. Open system Settings → General → VPN & Device Management → VPN. If there are multiple entries, check the name first. Don’t change connections provided by your employer or school.
  3. Tap the info button next to the Shadowrocket entry, choose Delete VPN, and confirm. Return to the list and make sure the entry is gone. If there’s no delete button or Settings says the device is managed by an organization, stop and check with your device administrator.
  4. To use Shadowrocket again, return to Home and turn on the connection switch. Follow the system prompts to authorize it again. Once a manual connection works, restore On Demand if needed. This helps distinguish manual connection issues from automatic triggers.

Troubleshoot missing prompts, a switch that turns off, or connection timeouts

First note three things: whether Shadowrocket appears in the system list; whether the switch turns off immediately or only after a delay; and whether the device can reach websites that normally work when VPN is disconnected. Don’t delete the configuration, change nodes, and modify routing all at once, or you won’t know which change affected the result.

Error: The VPN server did not respond.

What it means: The system didn’t receive a timely response from the VPN connection. This alone doesn’t prove that VPN authorization was denied or that a proxy node has the wrong password.

What to try: Check that the connection used the Shadowrocket VPN entry. Then disconnect the VPN and make sure your Wi-Fi or cellular connection works. On public Wi-Fi, complete any required network sign-in, then retry from Home.

  • No entry and no confirmation prompt: Make sure you’re using the connection switch on Home, not a node test. Check whether the system says the device is managed by an organization. On a managed device, ask the administrator whether users are allowed to add VPN configurations.
  • An entry exists, but the switch turns off quickly: Note any message shown when you start connecting, and check whether another VPN is already in use. For a connection you manage, disconnect it and try again. Don’t disable a work connection yourself. If you want to connect through a proxy, check that the correct node is selected on Home.
  • The system says Connected, but a website won’t load: Test the same website with the VPN disconnected and connected, and compare the results. Then check Global Routing. If Config is selected, open Config and check the configuration in use and its rules. A Connected status doesn’t show which route traffic to that site takes or whether the proxy server is reachable.

When reporting the issue, include the exact system message, network type, whether the system VPN entry exists, and whether you can reproduce the problem with a manual connection. Before sharing screenshots, hide device identifiers, server addresses, and login credentials. Checking system authorization doesn’t require sharing a subscription URL or device passcode.

Download Shadowrocket