About Blog Documentation FAQ GitHub

Installation

Yggdrasil can be downloaded for major platforms from our GitHub Releases page. Additionally, installation guides are available for the following platforms/distributions.

---

🚨 Please remember to check for Yggdrasil updates regularly. 🚨 Yggdrasil does not have a built-in method of notifying you when new versions are available. You may want to subscribe to the GitHub Releases Atom feed or consider watching the GitHub repository (a “Custom” watch can be used to subscribe to release notifications only). Release notifications are also sent in our Matrix room.

---

Linux

Yggdrasil is well supported on Linux. There are a number of distribution packages and additional installation instructions available:

• Debian, Ubuntu, elementaryOS, Linux Mint and similar
• Red Hat Enterprise Linux, Fedora, CentOS and similar
• Gentoo Linux
• OpenWrt
• Manual install or build from source

macOS

Yggdrasil is well supported on macOS. The preferred installation method is the .pkg installer:

• macOS .pkg installer
• Manual install or build from source

Windows

Yggdrasil works on Windows and an MSI installer is available, but the installer is supported on a best-effort basis only and is not well tested.

iOS

Yggdrasil is supported on iOS with the following applications:

• Yggdrasil for iOS on TestFlight (source code)

Android

Yggdrasil is supported on Android with the following applications:

• Yggdrasil for Android (source code)

FreeBSD

Yggdrasil is well supported on FreeBSD and an official net/yggdrasil port is available.

Ubiquiti EdgeRouter

Yggdrasil is well supported on EdgeOS 2.x and packages are available.