Prerequisites
- macOS 10.14 or later
- WireGuard configuration file (provided by WRLD)
Installation
1
Install WireGuard
2
Import Configuration
- Open WireGuard from Applications
- Click Import tunnel(s) from file (or drag the
.conffile onto the app) - Approve any system permission prompts
- The tunnel will appear in your list
3
Activate the VPN
- Select your tunnel from the list
- Click Activate
- You may need to enter your macOS password
- The status will show “Active”
Menu Bar Access
Once configured, you can quickly toggle the VPN from the menu bar:- Click the WireGuard icon in the menu bar
- Select your tunnel to activate/deactivate
Troubleshooting
Permission denied
Permission denied
- Go to System Settings > Privacy & Security > VPN
- Ensure WireGuard is allowed to add VPN configurations
Configuration won't import
Configuration won't import
- Verify the
.conffile is valid - Check that you received the correct file from WRLD
Connected but can't access resources
Connected but can't access resources
- Check if Private Relay is disabled (see iOS Private Relay guide)
- Verify your IP is whitelisted