Skip to main content

​
Prerequisites

  • Linux distribution with kernel 5.6+ (or wireguard-dkms for older kernels)
  • WireGuard configuration file (provided by WRLD)
  • Root/sudo access

​
Installation

sudo apt update
sudo apt install wireguard

​
Configuration

1

Place Configuration File

Copy your .conf file to the WireGuard directory:
sudo cp /path/to/wrld.conf /etc/wireguard/wrld.conf
sudo chmod 600 /etc/wireguard/wrld.conf
2

Start the VPN

sudo wg-quick up wrld
You should see output indicating the interface is configured.
3

Verify Connection

sudo wg show
This displays the active tunnel, peer information, and transfer statistics.

​
Disconnect

sudo wg-quick down wrld

​
Auto-Start on Boot

To start the VPN automatically: 
sudo systemctl enable wg-quick@wrld
sudo systemctl start wg-quick@wrld

​
Troubleshooting

Install the resolvconf package:
# Ubuntu/Debian
sudo apt install resolvconf

# Or use systemd-resolved
sudo apt install systemd-resolved
  • Check firewall rules (UDP port 51820 must be allowed outbound)
  • Verify your configuration file is correct
  • Ensure your IP is whitelisted on the server

​
Need Help?

Contact helpdesk@wrld.tech.