macOS Client

Configuration of the Hoppy interface using the WireGuard GUI (App Store version).

INFO

Homebrew and MacPorts versios of WireGuard exist, but have different system behavior which could cause issues (e.g. DNS)

Generate a Keypair

Open WireGuard and click Add Empty Tunnel. It should pre-populate the configuration with a private key and public key. Name the VPN config whatever you like.

Manual Configuration

Paste in the following template, except for the line with PrivateKey. For each #comment, edit the subsequent line using the instructions provided.

[Interface]
PrivateKey = <your_private_key>

# Use IP Addresses from Hoppy, IPv6 address must end in ::1 or higher
Address = <ipv4_here>, <ipv6_here>

DNS = 1.1.1.1, 2606:4700:4700::1111

[Peer]
# Use Server Key from Hoppy
PublicKey = <server_public_key_here>

# Use Endpoint from Hoppy
Endpoint = <endpoint_here>

AllowedIPs = ::/0, 0.0.0.0/0
PersistentKeepalive = 55

Finally, click 'Save'.

Update Client Public Key

Copy the displayed public key (located under tunnel status). On the Modify Subscription page, paste your key into the 'Client Public Key' section. You may have to click the 'Clear Private Key' button before doing so.

It usually takes around 5 minutes for the client public key changes to propagate to our servers, but it can take up to 15 minutes.

Starting the Interface

Simply click Activate, or use the WireGuard menubar icon to start your newly created tunnel. You can enable 'On-Demand', to have the tunnel automatically start whenever you connect to Ethernet and/or certain WiFI networks.