yggdrasil

Yggdrasil is an experimental, end-to-end encrypted IPv6 overlay network and compact routing scheme.

It is designed as a decentralised alternative to the structured routing protocols commonly used on today’s Internet, and as a possible foundation for large-scale mesh networks.

This package contains:

• yggdrasil — the network daemon
• yggdrasilctl — the administration utility
• a systemd service for Sailfish OS

Configuration

During installation, the package creates a unique configuration file:

/etc/yggdrasil.conf

The configuration contains the private key that determines your Yggdrasil IPv6 address. Keep this file private and back it up if you want to preserve the same Yggdrasil identity.

The package does not overwrite an existing non-empty configuration file during upgrades.

Connecting to the network

Yggdrasil may discover nearby nodes through multicast on a local network. To connect through the Internet, add one or more public or private peers to the Peers section of:

/etc/yggdrasil.conf

After changing the configuration, restart the service:

devel-su systemctl restart yggdrasil

To enable Yggdrasil automatically at boot and start it immediately:

devel-su systemctl enable --now yggdrasil

Check the service status with:

systemctl status yggdrasil

You can inspect the local Yggdrasil node with:

yggdrasilctl getSelf

The Yggdrasil interface will usually appear as tun0 and receive an IPv6 address from the 200::/7 range.

Important

Yggdrasil is experimental software. Routing behaviour, configuration formats and interoperability may change between releases.

The generated configuration and private key should not be shared publicly.