2019-03-15 17:32:23 +00:00
---
sitemap: true
2024-08-03 17:50:46 +01:00
tags: dontlink
2019-03-15 17:32:23 +00:00
---
# Installation
2021-06-06 12:14:51 +01:00
Yggdrasil can be downloaded for major platforms from our [GitHub Releases ](https://github.com/yggdrasil-network/yggdrasil-go/releases ) page. Additionally, installation guides are available for the following platforms/distributions.
2019-03-15 17:41:28 +00:00
2024-02-15 18:47:21 +00:00
---
2024-02-15 18:46:17 +00:00
🚨 **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 ](https://github.com/yggdrasil-network/yggdrasil-go/releases.atom ) or consider [watching the GitHub repository ](https://github.com/yggdrasil-network/yggdrasil-go ) (a "Custom" watch can be used to subscribe to release notifications only). Release notifications are also sent in our [Matrix room ](https://matrix.to/#/#yggdrasil:matrix.org ).
2024-02-15 18:45:27 +00:00
2024-02-15 18:47:21 +00:00
---
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/linux.svg" /> Linux
2019-03-15 17:32:23 +00:00
2021-06-06 12:14:51 +01:00
Yggdrasil is well supported on Linux. There are a number of distribution packages and additional installation instructions available:
2019-03-15 18:27:41 +00:00
- [Debian, Ubuntu, elementaryOS, Linux Mint and similar ](installation-linux-deb.md )
- [Red Hat Enterprise Linux, Fedora, CentOS and similar ](installation-linux-rpm.md )
2020-03-28 11:11:37 +01:00
- [Gentoo Linux ](installation-linux-gentoo.md )
2023-01-24 22:21:37 +01:00
- [OpenWrt ](installation-linux-openwrt.md )
2019-03-15 17:47:53 +00:00
- [Manual install or build from source ](installation-linux-other.md )
2019-03-15 17:41:28 +00:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/apple-mac.svg" />macOS
2019-03-15 17:41:28 +00:00
2021-06-06 12:14:51 +01:00
Yggdrasil is well supported on macOS. The preferred installation method is the `.pkg` installer:
2019-03-15 18:27:41 +00:00
- [macOS `.pkg` installer ](installation-macos-pkg.md )
2019-03-15 17:48:54 +00:00
- [Manual install or build from source ](installation-macos-other.md )
2019-03-15 18:02:34 +00:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/windows.svg" /> Windows
2019-07-20 11:28:57 +01:00
2023-09-11 23:58:07 +01:00
Yggdrasil works on Windows and [an MSI installer is available ](installation-windows.md ), but the installer is supported on a best-effort basis only and is not well tested.
2021-06-06 12:14:51 +01:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/smartphone-device.svg" /> iOS
2021-06-06 12:14:51 +01:00
2021-06-25 17:52:27 +01:00
Yggdrasil is supported on iOS with the following applications:
2024-08-03 17:50:46 +01:00
- [Yggdrasil for iOS on TestFlight ](https://testflight.apple.com/join/jZNsIkRr ) ([source code ](https://github.com/yggdrasil-network/yggdrasil-ios ))
2021-06-06 12:14:51 +01:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/smartphone-device.svg" /> Android
2021-06-06 12:14:51 +01:00
2021-06-25 17:52:27 +01:00
Yggdrasil is supported on Android with the following applications:
2024-08-03 17:50:46 +01:00
- [Yggdrasil for Android ](https://github.com/yggdrasil-network/yggdrasil-android/releases ) ([source code ](https://github.com/yggdrasil-network/yggdrasil-android ))
2021-06-06 12:14:51 +01:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/computer.svg" /> FreeBSD
2021-06-24 19:55:06 +01:00
Yggdrasil is well supported on FreeBSD and [an official `net/yggdrasil` port ](https://www.freshports.org/net/yggdrasil/ ) is available.
2021-06-06 12:14:51 +01:00
2024-11-18 23:14:27 +00:00
### <img src="/assets/images/iconoir/server-connection.svg" /> Ubiquiti EdgeRouter
2021-06-24 19:55:06 +01:00
Yggdrasil is well supported on EdgeOS 2.x and [packages are available ](installation-linux-edgeos.md ).
