Primary devices · First installation
Buy, install and open Shadowrocket on iPhone
On iPhone, open the App Store product page using the Apple ID you want to keep the purchase under. Verify the app, then confirm the purchase at the price shown in the store. Refer to the App Store page for system requirements and check compatibility before paying. Don’t assume your device is compatible based only on its name or someone else’s experience.
After confirming the purchase, wait for the App Store to finish downloading and installing the app. If progress stalls, check the store message, available storage and network connection. Avoid making repeated payments. Use your purchase history and the App Store status to confirm whether the purchase went through; the app icon not appearing on the Home Screen right away doesn’t necessarily mean the transaction failed.
After opening the app for the first time, import your existing details
Installing the app only means the client is ready to use; it doesn’t automatically provide a server connection. Get existing subscriptions from your service provider and manage their import in Subscribe. If you have individual server details, open Add Server and enter the fields for the protocol you use. Check that your information is complete before importing, and don’t mistake an account management page for a subscription URL.
The first time the app establishes a connection, iOS asks permission to add a VPN configuration. This system prompt allows the app to manage the relevant network connection. Confirm that the request comes from Shadowrocket before deciding whether to allow it, then follow the system prompts to authenticate. Installing the app alone usually doesn’t complete this step, and seeing the permission prompt doesn’t mean the server has been verified.
If you previously denied permission, try connecting again in the app and check whether the system prompts you again. If the expected prompt doesn’t appear, check the VPN configuration status in your device settings. Don’t delete other configurations in bulk if you’re unsure what they do. Devices managed by an organization may also be subject to management policies; follow the applicable requirements.
Check connection setup separately from the App Store purchase
After granting permission, check the selected server and Global Routing. Config handles connections according to the rules in the configuration; Proxy and Direct serve different purposes. Don’t choose a mode at random just because you’ve bought the app. Confirm these outcomes in order: the purchase succeeded, the VPN configuration was approved, and access works as expected.
For the full steps to import, choose a routing mode and test the connection, see the Shadowrocket user guide. If installation succeeds but the connection doesn’t work as expected, follow the connection troubleshooting guide. Check the network, server details, rules and DNS in that order rather than buying the app again.