Setting up a VPN on Mac from scratch? First, check whether your provider gave you a subscription link, a dedicated client, or server details. Subscription links usually need to be imported into a compatible client; you can’t simply paste them into macOS VPN settings. Once connected, check that the apps you want to use are actually routed through your selected connection.
Mac VPN setup options
Your setup method depends on the details provided by your service. Opening a subscription link in a browser isn’t an installation step, and seeing a VPN menu in System Settings doesn’t mean macOS can read every subscription format. Use the table below to find the right starting point.
| What you have | Where to start | What to check first |
|---|---|---|
| Subscription link | Add the subscription in a compatible client | Client support for the subscription format and the protocols used by its connections |
| Dedicated client | Install it from the provider’s designated source and follow the app’s instructions | Whether you need to sign in or import a configuration separately |
| VPN details supported by macOS | Add a VPN configuration of the corresponding type in System Settings | Whether the provider supplied a server address and the required authentication details, such as parameters for IKEv2 |
The subscription format determines whether a client can read its connections; protocol support determines whether it can connect to them. For example, being able to import a subscription containing Shadowsocks entries doesn’t mean the same client also supports its VLESS entries. Don’t assume every connection will work just because the import succeeded.
Client installation and system permissions
- Check your macOS version and chip. Open About This Mac from the Apple menu to see your macOS version and chip. If the download page offers separate builds for Apple silicon and Intel, choose the one that matches your Mac rather than guessing based on its model year. Download the app from the provider’s designated source. GangVPN users can find the client on the download page in the user dashboard.
- Install the app as directed by its publisher. Apps in disk images usually need to be dragged into Applications before you open them from that folder. For an installer package, follow the installer’s instructions. If an app won’t open, check its source, macOS compatibility, and the publisher’s guidance. Don’t disable system security protections just to launch it.
- Check any network configuration request. A client that uses a system tunnel may ask to add a VPN configuration or enable a network extension the first time you connect or switch modes. Make sure the app name and action in the prompt match what you’re doing, then approve it as instructed by macOS. Modes that use only a system proxy may not show this prompt.
- Check the permission status as prompted. If the client is still waiting for approval, search for “VPN” or “Network Extensions” in System Settings and check the relevant item against the app’s instructions. Menu locations can vary between macOS versions. If your Mac is managed by your workplace or school and network changes are restricted, contact the administrator.
Importing a subscription and choosing a connection
Copy the subscription URL intended for the client from your service dashboard; don’t copy the dashboard’s web address by mistake. In the client, look for an option such as “Subscription,” “Configuration,” or “Import from URL,” then paste the link and refresh. Once the list appears, make sure the newly imported configuration is enabled. Some clients keep old configurations, so the list may update without changing the active one.
For your first test, choose one connection and verify it in the same app. Don’t change connections and modes at the same time. In rule mode, the configuration determines which requests connect directly and which use a proxy. If the client offers global mode, it generally routes only traffic handled by the client through the selected exit; it doesn’t mean every app on your Mac is covered. With system proxy enabled alone, apps that ignore system proxy settings may still connect directly. If you need to route those apps too, check whether the client offers tunnel mode and review its system permission instructions.
Updating a subscription and establishing a connection are separate steps. If the list is empty or an update fails, first check that your basic connection can open the service dashboard, then make sure you copied the full URL and that it hasn’t changed. If the list updates but the connection times out after you select an entry, check the connection log and your current network instead of repeatedly importing the subscription. Subscription URLs may contain access credentials; don’t share them in group chats, public screenshots, or online conversion tools.
Connection status and how to verify it
A client showing “Connected” only means it reports that a connection has been established; it doesn’t prove that a particular app’s requests use the expected route. Disconnect first, then use the same browser to note the result on a trusted public IP lookup page. Connect again, reload the page, and compare the exit IPs. In rule mode, the lookup page may connect directly based on your rules, so an unchanged IP doesn’t prove the connection failed.
- ✅ Repeat a typical task in the app you actually plan to use, such as opening a familiar website or starting a sync. If the client provides request logs, check which rule matched the destination domain and which route it used.
- ✅ If a browser works but a desktop app doesn’t, first check whether the app follows system proxy settings and whether its requests reach the client. Then consider trying a different connection.
- ❌ A changed public IP alone doesn’t prove that DNS requests use the same route. If the DNS path matters, consider trusted DNS test results alongside the client’s DNS settings and your browser’s encrypted DNS settings.
How to tell if setup is working: The intended task succeeds in the target app, and request logs or an exit IP comparison confirm that traffic follows the expected route. A browser test only reflects that browser request; it can’t confirm the route for every app.
Common issues and troubleshooting steps
No websites load after connecting
Disconnect the client first and make sure your current network works on its own. If hotel or guest Wi-Fi requires a sign-in page, complete that step before connecting. If things work again after disconnecting, check whether another proxy or VPN app is running. Quit any similar tools you started and can safely turn off, then test the original connection again. If the problem affects only one connection, keep the mode unchanged and compare it with another connection in the same group.
Only one website or app isn’t working
Use the same app to open other destinations and narrow down the problem. Then check whether the failed request matched a direct-connection rule, was routed through a different exit, or failed during DNS resolution. If the page loads but you can’t sign in, distinguish the website’s login message from a client-reported network timeout; the two issues need different fixes. For further troubleshooting, follow the troubleshooting guide to check the connection and DNS resolution.
Internet still doesn’t work after quitting the client
First reopen the client and use its disconnect button to turn off the system proxy or tunnel, then quit normally. If you previously set up a proxy manually, check the proxy options for your current network service under System Settings → Network. Remove only settings you added yourself and no longer need; leave organization-managed settings untouched. If you still need help, note your macOS version, client version, connection mode, and the exact error message, then find a support option on the contact page. Redact subscription URLs and authentication details before sending anything.