The key to setting up an iOS VPN is to handle client installation, subscription import, and connection checks as separate steps. Installing the app doesn't mean you have a working route, and seeing “Connected” doesn't guarantee that an app is using the expected exit route. Follow the steps in order to get a clear result at each stage and avoid repeatedly deleting and reinstalling the app when something goes wrong.
This guide covers how subscription-based clients typically work without relying on the layout of any particular app. Depending on the version, the relevant option may be called “Subscription,” “Configuration,” or “Profiles.” Use the download link and compatible configuration shown in your VPNGJ account panel.
Before you start: Know the difference between your account, client, and subscription
Your VPNGJ account lets you sign in to the dashboard, view your plan, and access your subscription. The iOS client reads the configuration and establishes the connection. The subscription link is how the client retrieves route settings. These are different credentials: entering your dashboard password in the client's server password field usually won't connect you.
You can get started with VPNGJ using only a username and password—no email address required. Note that an active plan is required to access the iOS download link; don't assume that the “sign in to download” option available on other platforms applies to iPhone. Check the download page and App Store listing for any additional app availability requirements. Don't assume the app is free or available in your region.
Before you begin, make sure Safari can open a regular webpage, and disconnect any other active VPN. If your basic internet connection isn't working, subscription updates and VPN connections may fail too, making it easy to mistake a local network issue for a service problem.
- ✅ You can sign in to the VPNGJ dashboard and confirm that your plan is active.
- ✅ Find the iOS client link in the dashboard instead of using a desktop installer.
- ✅ Keep your subscription link private; don't post the full link in a public forum.
- ✅ Note your existing network settings and disconnect other VPNs so you don't change several things at once.
Get the client: Check its source and compatibility first
Sign in and open the client download page for the iOS instructions. Before installing, verify the app name, developer, and system requirements. If you're redirected to the App Store, check the listing details rather than relying on a similar-looking icon. If the link won't open, check your plan status and any App Store messages, then contact support. Don't look for replacement installers on unfamiliar websites.
iOS and desktop operating systems handle installation and network permissions differently. A file that a desktop client can import may not work in an iOS client. Even when the protocol name is the same, subscription format, configuration fields, and client version can affect compatibility. Use the import method provided for your client in the dashboard.
Shadowsocks, VMess, Trojan, VLESS, Hysteria2, and TUIC are protocol names you may see in proxy configurations. Not every client supports all of them, and their appearance here doesn't mean VPNGJ offers every protocol listed. Don't change protocol fields based on a name alone: the server configuration must match the client's implementation, and the name by itself doesn't determine whether a connection will work.
Import your subscription: Give the link to the client, not the system server field
A subscription link is usually used to retrieve configuration; it isn't an address to enter in iOS Settings under VPN “Server.” Unless your provider gives you the connection type, server, and authentication details for manual setup, don't guess at the values in system settings. For subscription-based clients, import the link from within the app.
- Get the subscription from your dashboard. Sign in and find the subscription option for your client. If one-tap import is available, follow the prompt to open the right app. Otherwise, copy the subscription link.
- Add the subscription in the client. Find the option to add a subscription or import from a link, then paste the full URL and save it. A clipboard access prompt only means the app wants to read copied content; it doesn't mean the VPN is connected.
- Update the subscription. Wait for the client to retrieve the configuration, then check that routes or policy groups appear. Saving a link without a successful update usually means the client hasn't received usable server details yet.
- Select the imported configuration. Some apps can store multiple subscriptions. Make the one you just imported the active configuration, then choose a node or policy group.
If you see an unsupported format message, check whether you copied the dashboard URL, a sign-in redirect, or a subscription intended for a different client. If the request fails, check your internet connection, sign-in status, and plan status. If you reset the subscription, replace the old link in the client. Refer to the client's message for the specific error details.
A subscription link may contain a token that identifies your account and plan, so protect it like a password. Hide the full link, QR code, and authentication fields in screenshots. Even after an update succeeds, don't share the configuration file publicly; it may contain connection credentials.
Allow VPN access: Understand system permissions and connection status
The first time you connect, iOS may ask whether the app can add a VPN configuration. For clients that use the system network extension, this permission lets the app handle the relevant network traffic. Verify that the request comes from the app you just installed, then allow it and complete device authentication as prompted.
This permission doesn't mean iOS has checked every route or that the site you want will be accessible. The app may have created a local network interface while the remote node is still unreachable. Alternatively, a split-tunneling rule may send a particular site directly. Check the system status and actual access separately.
| Prompt or symptom | What it usually means | What to check next |
|---|---|---|
| Request to paste content | The app is about to read the clipboard | Confirm you copied the subscription link from your own dashboard |
| Allow VPN configuration | The app is requesting a system network configuration | Verify the app's source, then approve the system permission |
| Subscription updated | The configuration retrieval process is complete | Check that the active configuration, route, and policy group are correct |
| VPN shows as connected | The system considers the connection active | Check the route used by the request and whether the site is accessible |
| The website still won't load | Possible causes include the route, DNS, rules, or site restrictions | Troubleshoot one layer at a time instead of assuming installation failed |
If you accidentally tapped “Don't Allow,” return to the client and try connecting again. You can also search for “VPN” in Settings to check the configuration status. Don't reset all network settings as a first step: that may erase saved network information without fixing a subscription format or remote node issue.
Verify the connection: Check access, exit route, and split tunneling
Choose a route and leave it selected. Open a regular webpage to confirm basic access, then try the international site you need. This helps distinguish a general internet outage from an issue affecting only one service. If webpages load but a particular app doesn't, check that app's account, region, and service status too; the VPN switch alone doesn't tell the whole story.
Check the exit route in the context of your current mode
Use a reputable public IP lookup site to check the apparent exit region, but first confirm whether your current rules send that site through the proxy. In rule mode, the lookup may go direct, so a local exit doesn't necessarily mean all proxy requests are failing. Likewise, a changed exit on the lookup page doesn't prove that every app sends all its traffic through the same route.
If the client provides request logs or rule-match details, use them to check which policy matches the target domain, then see which route that policy selected. To isolate an issue, you can temporarily switch to a more explicit proxy mode if the app supports it, then restore your usual rules when you're done. Check the client documentation for mode names and coverage.
DNS checks: Don't judge by region alone
DNS translates domain names into addresses. Even with a working proxy connection, unsuitable DNS settings can prevent some sites from loading. Start with the DNS settings recommended by the client. Avoid changing system DNS, app DNS, and split-tunneling rules at the same time, or it will be difficult to tell what made a difference.
A DNS leak generally means that a query handled by an expected resolver path was sent through a different one. A difference between the resolver's region and the exit region on a test page isn't enough to draw a conclusion; resolvers may use distributed infrastructure. Consider the client's DNS policy, direct-connection domain rules, and test results together. A browser-based test also doesn't represent every app.
Connection problems: Troubleshoot by where they occur
No routes in the client: Go back to the subscription update step and check the link, format, and plan status. Switching Wi-Fi networks or changing nodes may not help if the client hasn't received a valid configuration. An empty list doesn't mean every server is down.
Routes are listed, but the connection fails: Keep your current settings, try a different route, then test another internet connection. Change one thing at a time and note whether the error changes. If results differ across networks, include that context when contacting support rather than repeatedly reinstalling the client.
Webpages load, but one app doesn't: Check which rules match the app's domains and whether they're mistakenly going direct. Also check whether the platform restricts access based on account region or exit type. A successful VPN connection doesn't change platform permissions or content availability by region.
The connection doesn't recover after switching networks: Disconnect and reconnect in the client, then check that the intended configuration is still selected. Refresh the subscription if it has changed or an update failed; there's no need to reimport it as a default fix for every problem.
IEPL, relay, and direct connections describe route arrangements, not iOS installation options. A direct connection typically reaches an overseas entry point through your own network; a relay adds a forwarding hop; an IEPL route includes a dedicated cross-border link segment. The actual path still depends on local connectivity, the exit, and the destination service, so the name alone can't guarantee access to a particular site.
If you still can't identify the issue, use the support ticket page to share the client name, system version, selected route, network in use, error message, and steps you've tried. Remove sensitive information from logs and screenshots. Don't submit passwords, full subscription links, or QR codes.
Everyday use: Keep your configuration and update when needed
Once setup is verified, keep a short note of the client, subscription name, usual policies, and a route that works. Update the subscription in the app when it changes; you don't need to create a new configuration each time. If you switch clients, check format compatibility again.
VPNGJ has no device limit, but each device still needs the subscription imported and its connection verified. Choose a plan based mainly on your data needs; the device limit doesn't mean each device gets a separate data allowance. Monthly data resets on the activation date each month, and data add-ons never expire. See the plans page for pricing and usage details. Refunds are available within 60 days, no questions asked.
How to tell setup is complete: You've verified the client source, updated the subscription, approved the system permission, and confirmed that the target request matches the expected rule and loads correctly. Checking each result is more reliable than relying on a VPN icon alone. Troubleshoot step by step: subscription, connection, DNS, rules, then the destination service.