Linux Client

Configuration of the Yggdrasil Private Relay on Linux

Install Yggdrasil

Installation and build instructions can be found on the official website. We recommend Debian 13+, Ubuntu 25.10+, Fedora 42+ or Alpine Linux for out-of-the-box support.

Generate a Keypair

If a package manager is used for installation, a keypair is automatically generated, usually under /etc/yggdrasil/yggdrasil.conf or /etc/yggdrasil.conf.

To generate a new keypair and configuration file for your client run:

yggdrasil -genconf > /etc/yggdrasil.conf

Manual Configuration

Edit the yggdrasil.conf using the template below. The Private Relay address can be found in the "Manage Subscription" page under "Yggdrasil Private Relay --> Edit --> Peer Configuration". Any changes made here may take up to 15 minutes to propogate to our servers.

For each #comment, edit the subsequent line using the instructions provided.

{
    PrivateKey: XXXXXXXX
    # Replace the address here with the Peer Configuration from above
    Peers: [
        "tls://hjxzjhx.hoppy.link:443/?sni=9b56.hoppy.link&password=abcd1234"
    ]
    InterfacePeers: {}
    Listen: []
    # Set Beacon and Listen to false to disable LAN peering
    MulticastInterfaces: [
        {
            Regex: .*
            Beacon: true
            Listen: true
            Password: ""
        }
    ]
    AllowedPublicKeys: []
    IfName: auto
    # For latency sensitive applications, e.g. game streaming, set MTU to 1280
    IfMTU: 65535
    NodeInfoPrivacy: false
    NodeInfo: {}
}

Restart Yggdrasil

For systemd-based distributions, the following will reload the current configuration and make Yggdrasil auto-initialize on boot:

sudo systemctl restart yggdrasil
sudo systemctl enable yggdrasil

Get Yggdrasil IP address

To print out your new Yggdrasil IP address to the terminal:

sudo yggdrasilctl getself