Aug 27, 2026 · Getting started · About 8 min

How to Set Up Shadowrocket for the First Time: VPN Permissions and the Home Screen

On first launch, iOS asks to add a VPN configuration. Learn why to allow it and what the Home screen’s Not Connected switch, Global Routing, Connectivity Test, and SERVER list do.

At a glance

This guide uses the Home screen on iPhone and iPad as an example. It’s for anyone setting up Shadowrocket after installation or on a new device. Check three things before connecting: whether iOS allows the VPN configuration, whether a usable server is selected, and whether traffic is routed as expected. Once permission is granted, follow the steps below to test the connection and narrow down which of these is causing an issue.

Allowing a VPN configuration on first launch

Shadowrocket uses an iOS VPN configuration to handle selected network traffic, then routes it according to Global Routing. The system prompt may appear during first-launch setup or the first time you turn on the connection switch at the top of Home. Allowing the configuration lets Shadowrocket establish a connection; it does not add a server or confirm that one is reachable.

  1. Open Home

    After opening the app, start on Home. If the permission prompt hasn’t appeared, check whether SERVER already has an entry. If the list is empty, add a server as described below, then try turning on the switch.

  2. Select a server

    On Home, tap the server you want to test under SERVER and make sure the selection indicator is on the right entry. A server appearing in the list means it’s saved, not that it’s selected or reachable.

  3. Approve the system prompt

    Return to Home and turn on the connection switch at the top. When iOS asks to add a VPN configuration, check that Shadowrocket is the requesting app, tap Allow, and complete device authentication if prompted.

  4. Check the connection status

    Return to Home and see whether the status changes from Not Connected to Connected. If the switch turns off again, check system permission, the selected server, and your current network first. Avoid changing the server and routing mode at the same time while troubleshooting.

Home switch and SERVER: connection status vs. server selection

Not Connected at the top of Home means Shadowrocket hasn’t established a connection. Even after the status changes to Connected, test the destination site separately: the system connection status doesn’t check server health, and routing rules may send that site through DIRECT. Use SERVER to choose the server for testing. After switching entries, test again instead of relying on results from the previous server.

An empty SERVER list: add a server using details you already have

If you have a subscription link
  • Get your subscription from your service provider. Before saving it, check that the link is complete, especially its query parameters. Don’t share the full link in troubleshooting screenshots.
  • On Home, tap “+” in the top-right corner, set Type to Subscribe, enter the subscription link, and save. Return to Home and check that the subscription has expanded into selectable server entries.
  • After updating an existing subscription, check that the server you need is still listed and the intended entry is selected. Updating the list and connecting are separate actions.
If you have individual server details
  • On Home, tap “+” and choose the Type specified by your provider. Shadowsocks, Trojan, and WireGuard use different fields; don’t infer the protocol from the port number alone.
  • Enter the address, port, and authentication or key details required by that protocol, using the information you were given. If the port is listed as 443, enter 443; this is an example, not a default shared by all protocols.
  • After saving, return to SERVER and select the entry. If it saves successfully but won’t connect, compare the fields with the original details rather than trying other protocols at random.

With either method, return to SERVER to confirm the selected entry, then turn on the connection switch at the top of Home.

Global Routing: choose how traffic is handled

On Home, choose a routing mode under Global Routing. This controls “which route traffic takes,” not “whether the connection is on.” Note the current setting before switching and restore it when you’re done; temporary use of Proxy or Direct may change how other apps access the network.

Config

Recommended

Uses the rules in the current Config to decide whether traffic is proxied, sent direct, rejected, or handled another way. Requests that don’t match earlier rules are handled by FINAL in the configuration, so they don’t necessarily go direct.

Use when: You’ve checked the current configuration and want traffic routed by its rules.

Proxy

Sends traffic handled by Shadowrocket through the proxy, without applying Config rules individually. Keep the network and server unchanged, then briefly test the same address to see whether the issue is related to rule selection.

Use when: A server is selected and you want to check whether its proxy route can reach a test destination.

Direct

Sends traffic handled by Shadowrocket directly. Choosing Direct doesn’t turn off the Home switch; to disconnect Shadowrocket, use the connection switch at the top.

Use when: The destination should connect directly and you want to compare results on the same network.

Scene

Uses scene settings to determine routing behavior. If Scene is available, check the configured scene and its conditions. After switching networks, don’t assume the routing mode from the previous network still applies.

Use when: You have explicit scene settings and want to switch routes based on a scene.

Connectivity Test: understanding response times and timeouts

Run Connectivity Test on Home and check the result for the server you’re testing. A result in milliseconds means the test received a response under those conditions; it measures test response time, not download speed, and doesn’t guarantee that every site will load. A timeout means no response arrived in time. The destination, current network, server settings, or route conditions can all affect the result.

ms
A time measurement, not a throughput measurement
One destination
Compare routing to the same destination in a browser
One change
Change only the network, server, or routing mode in each test

Config and Settings: checks to make after connecting

For initial troubleshooting, use the manual switch and keep your existing configuration. Once you can reproduce the connection manually, check Settings → On Demand if you want connections to start or stop automatically under specific conditions. If the connection comes back after you manually disconnect, check this setting instead of repeatedly tapping the Home switch.

Config: check the rules

Prerequisite
On Home, select Config under Global Routing and confirm which configuration file is in use.
Example domain rule
DOMAIN-SUFFIX,example.com,PROXY: Routes matching domain requests through PROXY.
Example fallback rule
FINAL,DIRECT: Uses DIRECT when no earlier rule matches.

Rules are evaluated in order. These examples explain what the rules mean; don’t replace rules in your active configuration with them.

On Demand: check automatic connections

Where to find it
Settings → On Demand。
What it does
Starts or stops connections based on configured conditions, such as different behaviors for Wi-Fi and cellular networks.
How to verify
Note the existing conditions, switch networks once, then return to Home and check whether the switch behaves as expected.

On Demand controls when to connect; Global Routing controls how traffic is handled after connecting. These settings serve different purposes.

Download Shadowrocket and get started

Get Shadowrocket for iPhone and iPad on the App Store for a one-time payment of $2.99. Check the App Store listing for system requirements. Verify the developer is Shadow Launch Technology Limited and the app ID is 932747118. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free; get installers from this site’s download page.

Download Shadowrocket