Shadowrocket VPN Setup on iPhone & iPad: Why iOS Requests a VPN Configuration

Learn why iOS asks to add a VPN configuration when you connect for the first time, where to find it in Settings, and how to restore permission if it was denied or deleted.

At a glance

When you start a connection from Home in Shadowrocket for the first time on iPhone or iPad, iOS may ask for permission to add a VPN configuration. If you accidentally deny the request or delete the configuration, check for a Shadowrocket VPN entry in system Settings, then start the connection again from Home. Check your network and existing service settings only if the configuration is present but the connection still fails.

Why iOS asks to add a VPN configuration

The prompt usually reads “Shadowrocket” Would Like to Add VPN Configurations. It comes from iOS or iPadOS and asks whether Shadowrocket can add a VPN configuration to the system. Installing the app, importing a configuration, and granting permission to establish a VPN are separate steps. Being able to open Home and see an imported service entry does not mean iOS has allowed the VPN connection.

The system warns that network activity may be filtered or monitored because, when a VPN is active, traffic matching the system routes is handled by the VPN extension. If the prompt appears right after you turn on the connection switch in Home, check the app name shown and tap Allow. If you did not start a connection or the app name does not match, tap Don’t Allow and start the connection from within the app instead.

Find the VPN entry in system Settings

On your device, open Settings → General → VPN & Device Management → VPN and look for a Shadowrocket entry. Here, Settings means the iPhone or iPad’s system app, not the Settings tab in Shadowrocket. Menu names can vary by system language. If needed, search for VPN in system Settings and open the VPN list.

2 options
Permission prompt: Allow / Don’t Allow
3 menu levels
In system Settings, go to General → VPN & Device Management → VPN
2 checks
Check the configuration in the system VPN list and the session status in the connection status

How to tell: check the entry first, then its status

If the list contains a Shadowrocket entry with the status Not Connected, the configuration is saved but there is no active session. Start a connection in the app and check the prompt. A disconnected status alone does not mean permission has been revoked.

If the list only shows VPNs managed by other apps or your organization, that does not confirm Shadowrocket has permission. You do not need to delete those entries to check. If several entries have the same or similar names, confirm which app or organization they belong to first. Don’t delete an entry if you can’t identify it by name alone.

Restore permission after denying or deleting the entry

If you tapped Don’t Allow by mistake, or confirmed that you deleted Shadowrocket’s system VPN entry, start a new configuration request from the app. Deleting a system VPN entry is different from deleting a service entry in the app. Before restoring permission, check Home: if the service you were using is still there, continue troubleshooting with that entry. You do not need to import it again just to restore permission.

  1. Check the system VPN entry

    Open system Settings → General → VPN & Device Management → VPN. Check whether the entry is missing or still listed. Don’t delete an existing entry just to make the prompt appear again.

  2. Return to the app’s Home screen

    Open Home in Shadowrocket and make sure your existing service entry is selected. If no items are available, restore your own service configuration before trying to connect.

  3. Start the connection again

    Turn on the connection switch in Home. If the system asks to add a VPN configuration again, check the app name, tap Allow, and authenticate if prompted.

  4. Check the connection status

    Check the system VPN list for a Shadowrocket entry, then check the connection status in Home. If the entry is present but the connection fails, note the exact error message instead of repeatedly deleting the configuration.

If the prompt still does not appear and the Shadowrocket entry is still missing, first address any blocking message shown in Home. Devices managed by a workplace or school may restrict changes to VPN configurations. If the system says a management policy is blocking the change, or a related system option is unavailable, share the exact message with your device administrator. Do not remove the management profile.

Troubleshoot a missing prompt, failed connection, or unexpected reconnection

First identify which step failed. If no entry was added after you tapped Don’t Allow, the issue occurred while creating the configuration. If the entry is present but the connection attempt fails, troubleshoot session establishment instead. Keep your existing service entry and routing settings, and change one thing at a time to pinpoint the issue.

Error: The VPN server did not respond.

What it means: The connection attempt did not receive the expected response. This message alone does not mean the VPN configuration was deleted.

What to do: First, make sure your basic network connection can load webpages. Then check that the address and port in your existing service match the values provided by your service provider. If it still fails, note your network type and the exact error, then ask your service provider to check the service status.

VPN configurations, management profiles, and app configurations

The system groups the VPN list and device management under the same page, which can lead people to call a VPN entry a VPN profile. In the steps described here, Shadowrocket asks to add a system VPN entry; you do not need to download and install a separate profile. Organizations can also use management profiles to deploy VPN settings. That is a different way to configure a VPN.

System VPN configuration
Saved and managed by the system to launch the corresponding VPN extension. If you delete this entry, the app may need to request permission to add it again the next time you connect.
Device management profile
May include VPN settings deployed by an organization, along with other management requirements. Removing this type of profile is not a troubleshooting step for Shadowrocket permission issues.
Shadowrocket app configuration
Existing service connection settings are saved in Home, while Config is for managing app configuration files. When Global Routing is set to Config, traffic routing is determined by the rules in the selected configuration. These settings and rules do not replace system VPN permission.
Download Shadowrocket for all platforms