Home / Tutorials / macOS

macOS WireGuard Setup

Follow this guide to set up WireGuard on your Mac

1

Download WireGuard from App Store

Download the official WireGuard app from the Mac App Store.

View in Mac App Store
💡 Tip: The WireGuard app is free and officially supported. It requires macOS 10.14 (Mojave) or later.
2

Install and Open WireGuard

After downloading from the App Store:

  1. Click "Get" or "Install" in the App Store
  2. Wait for the download and installation to complete
  3. Open WireGuard from your Applications folder or Launchpad
  4. You'll see an empty tunnel list on first launch
⚠️ System Extension: macOS may ask you to allow a system extension. Click "Allow" in System Preferences → Security & Privacy.
3

Get Your Configuration

Download your WireGuard configuration from the GetIP.online dashboard.

⚠️ Account Required: You need to create an account and generate a tunnel first.

Create Account
4

Import Configuration

Import your configuration into WireGuard:

  1. In the WireGuard app, click "Import tunnel(s) from file" or press ⌘+O
  2. Navigate to your Downloads folder
  3. Select your .conf file and click "Import"
  4. Your tunnel will appear in the tunnel list
💡 Alternative Method: You can also drag and drop the .conf file directly onto the WireGuard app icon in the Dock.
5

Activate Your Tunnel

Now you can connect to your IPv6 tunnel:

  1. Select your tunnel from the list
  2. Click the "Activate" button or toggle the switch
  3. The status indicator will turn green
  4. You'll see real-time transfer statistics
💡 Menu Bar: WireGuard adds an icon to your menu bar for quick access. You can activate/deactivate tunnels directly from there.
6

Verify Connection

Check that your tunnel is working correctly:

  1. The tunnel status should show a green indicator
  2. You'll see data being transferred in the statistics
  3. The menu bar icon will show the connection is active
💡 Test IPv6: Open Safari and visit test-ipv6.com to verify your IPv6 connection.

Using Terminal (Optional)

You can also verify using Terminal:

  1. Open Terminal (found in Applications → Utilities)
  2. Type ifconfig to see your network interfaces
  3. Look for the utun interface with an IPv6 address
  4. Test with ping6 google.com
?

Troubleshooting

Connection fails to activate

  • Check your internet connection
  • Ensure no other VPN software is running
  • Check System Preferences → Security & Privacy for blocked extensions
  • Try restarting the WireGuard app

Permission issues

  • Go to System Preferences → Security & Privacy → General
  • Look for a message about blocked software
  • Click "Allow" next to the WireGuard message
  • Restart WireGuard after allowing

Auto-connect on startup

  • Right-click on your tunnel in WireGuard
  • Select "Edit"
  • Check "On-Demand" options
  • Configure when the tunnel should automatically connect

All Set!

You're now connected to the IPv6 internet through GetIP.online. Your tunnel will remain active for 30 days.

Manage Tunnels Other Platforms