🌊 Debian Guide

Setting up Yggdrasil and Alfis on Debian and Ubuntu

← Back to Linux

Install Yggdrasil

sudo apt-get install apt-transport-https dirmngr
sudo mkdir -p /usr/local/apt-keys
gpg --fetch-keys https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/deb/key.txt
gpg --export BC1BF63BD10B8F1A | sudo tee /usr/local/apt-keys/yggdrasil-keyring.gpg > /dev/null
echo 'deb [signed-by=/usr/local/apt-keys/yggdrasil-keyring.gpg] https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/deb/ debian yggdrasil' | sudo tee /etc/apt/sources.list.d/yggdrasil.list
sudo apt-get update
sudo apt-get install yggdrasil
sudo systemctl enable --now yggdrasil

Configure Yggdrasil

Edit /etc/yggdrasil.conf and set our peers or choose your own:

  Peers: [
    tls://novaprospekt.holz.gg:9001
    tls://whiteforest.holz.gg:9001
  ]
sudo systemctl restart yggdrasil

Install Alfis

sudo wget -O /usr/bin/alfis https://github.com/Revertron/Alfis/releases/download/v0.8.5/alfis-linux-amd64-v0.8.5-nogui
sudo chmod +x /usr/bin/alfis
sudo wget -O /etc/systemd/system/alfis-default-config.service https://github.com/Revertron/Alfis/raw/v0.8.5/contrib/systemd/alfis-default-config.service
sudo wget -O /etc/systemd/system/alfis.service https://github.com/Revertron/Alfis/raw/v0.8.5/contrib/systemd/alfis.service
sudo wget -O /etc/systemd/system/alfis.sysusers https://github.com/Revertron/Alfis/raw/v0.8.5/contrib/systemd/alfis.sysusers
sudo wget -O /etc/systemd/system/alfis.tmpfiles https://github.com/Revertron/Alfis/raw/v0.8.5/contrib/systemd/alfis.tmpfiles
sudo systemctl enable --now alfis

Configure Alfis

Edit /etc/alfis.conf and set:

listen = "127.0.0.1:53"

Configure DNS

Create /etc/NetworkManager/conf.d/90-dns-none.conf:

[main]
dns=none

Set /etc/resolv.conf to:

nameserver 127.0.0.1

Testing the Setup

To confirm everything is working correctly, open your web browser and visit:

http://sanctum.ygg/

If the page loads successfully, your Yggdrasil and Alfis setup is working properly!