Help
Get Ghostunnel

Set up on macOS

Install WireGuard from the Mac App Store, import your configuration file and activate the tunnel.

You'll need a tunnel in your Ghostunnel account. If you don't have one yet, create a tunnel first.

1. Install WireGuard

Install WireGuard from the Mac App Store. It's also linked from Downloads.

2. Download your configuration

  1. Create a tunnel. Its configuration appears right away.
  2. Select Download .conf. The file is named after the tunnel (or its location), for example netherlands.conf.

The configuration is shown once, right after you create the tunnel — we don't keep its private key. Already left that page? Open the tunnel from Tunnels and select Get a new configuration.

3. Import and connect

  1. Open WireGuard from the menu bar and choose Import tunnel(s) from file.
  2. Choose the .conf file. If macOS asks to add VPN configurations, allow it.
  3. Select Activate.

To disconnect, select Deactivate, or switch the tunnel off from the WireGuard menu bar icon.

Tips

  • After importing, you can delete the downloaded file — WireGuard keeps its own copy. Don't share it: it contains your tunnel's private key.
  • If you create a new tunnel later, import its new file and remove the old tunnel from WireGuard.

Not connecting? See I can't connect.

More in Setup guides

Set up on Windows Install WireGuard for Windows, import your Ghostunnel configuration file and activate the tunnel. Set up on iPhone and iPad Install WireGuard from the App Store and add your tunnel by scanning its QR code. Set up on Android Install WireGuard from Google Play and add your tunnel by scanning its QR code. Set up on Linux Install wireguard-tools and bring the tunnel up with wg-quick using your downloaded configuration.

Still need help?

Email our support team and tell us what you tried — a screenshot helps.

[email protected]