2019-03-15 17:32:23 +00:00
---
sitemap: true
---
# Installation
2021-06-06 11:14:51 +00: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
2021-06-06 13:15:24 +00:00
Once you have installed Yggdrasil, take a look at:
- [Configuration ](configuration.md ) — information about configuring Yggdrasil
- [Public Peers ](https://github.com/yggdrasil-network/public-peers ) — public nodes to connect to
- [Public Services ](services.md ) — services running inside the Yggdrasil Network
2021-06-10 13:05:06 +00:00
### Linux
2019-03-15 17:32:23 +00:00
2021-06-06 11:14:51 +00: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 10:11:37 +00:00
- [Gentoo Linux ](installation-linux-gentoo.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
2021-06-10 13:05:06 +00:00
### macOS
2019-03-15 17:41:28 +00:00
2021-06-06 11:14:51 +00: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
2021-06-10 13:05:06 +00:00
### Windows
2019-07-20 10:28:57 +00:00
2021-06-16 16:43:14 +00: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 11:14:51 +00:00
2021-06-10 13:05:06 +00:00
### FreeBSD
2021-06-06 11:14:51 +00:00
Yggdrasil is well supported on FreeBSD and [an official `net/yggdrasil` port ](https://www.freshports.org/net/yggdrasil/ ) is available.
2021-06-10 13:05:06 +00:00
### Ubiquiti EdgeRouter
2021-06-06 11:14:51 +00:00
Yggdrasil is well supported on EdgeOS 2.x and [packages are available ](installation-linux-edgeos.md ).
2021-06-10 13:05:06 +00:00
### Android
2021-06-06 11:14:51 +00:00
2021-06-06 11:17:40 +00:00
An [Yggdrasil port to Android ](https://github.com/yggdrasil-network/yggdrasil-android/releases ) has been contributed by the community.
2021-06-06 11:14:51 +00:00
2021-06-10 13:05:06 +00:00
### iOS
2021-06-06 11:14:51 +00:00
Yggdrasil is supported on iOS but no binary builds exist at this time. You will need an Apple Developer subscription, access to the Network Extensions entitlements and to [build the app from source ](https://github.com/yggdrasil-network/yggdrasil-ios ).
