---
tags: dontlink
sitemap: true
---

Yggdrasil is an overlay network implementation of a new routing scheme for mesh networks. It is designed to be a future-proof decentralised alternative to the structured routing protocols commonly used today on the Internet and other networks.

The highlights of Yggdrasil are that it is:

<div id='indexicons'>
    <div class='icon'>
        <img src='/assets/images/iconoir/planet.svg' />
        <div>Scalable</div>
        <p>Supports large, complex or even internet-scale topologies</p>
    </div>
    <div class='icon'>
        <img src='/assets/images/iconoir/cloud-check.svg' />
        <div>Self-healing</div>
        <p>Network responds quickly to connection failures or mobility events</p>
    </div>
    <div class='icon'>
        <img src='/assets/images/iconoir/lock.svg' />
        <div>Encrypted</div>
        <p>Traffic sent across the network is always fully end-to-end encrypted</p>
    </div>
    <div class='icon'>
        <img src='/assets/images/iconoir/group.svg' />
        <div>Peer-to-peer</div>
        <p>Works entirely ad-hoc by design with no built-in points of centralisation</p>
    </div>
    <div class='icon'>
        <img src='/assets/images/iconoir/cpu.svg' />
        <div>Cross-platform</div>
        <p>Supported on Linux, macOS, Windows, iOS, Android and more</p>
    </div>
</div>

The current implementation of Yggdrasil is a lightweight userspace software router which is easy to configure and supported on a wide range of platforms. It provides end-to-end encrypted IPv6 routing between all network participants. Peerings between nodes can be configured using TCP/TLS connections over local area networks, point-to-point links or the Internet. Even though the Yggdrasil Network provides IPv6 routing between nodes, peering connections can be set up over either IPv4 or IPv6.

This is still an alpha-stage project and there may be some breaking changes in the future. Despite that, Yggdrasil is generally stable enough for day-to-day use and a small number of users have been using and stress-testing Yggdrasil quite heavily for a variety of use cases. If you are interested in or would like to get involved in the Yggdrasil project, start below:

<div id='indextable'>
    <div class='row'>
        <img src='assets/images/iconoir/download-circled-outline.svg' />
        <p markdown='1'>[Install](installation.md) and [configure](configuration.md) Yggdrasil on your own computer or router to join the network.</p>
    </div>
    <div class='row'>
        <img src='assets/images/iconoir/multi-bubble.svg' />
        <p markdown='1'>Come and chat to us in our [Matrix channel](https://matrix.to/#/#yggdrasil:matrix.org), or [read our channel backlog](https://view.matrix.org/room/%21vVtVcVdzAdhGFLzFwm:matrix.org/).</p>
    </div>
    <div class='row'>
        <img src='assets/images/iconoir/multi-window.svg' />
        <p markdown='1'>Explore the [internal services](services.md) available on the network, as contributed and operated by our users.</p>
    </div>
    <div class='row'>
        <img src='assets/images/iconoir/github.svg' />
        <p markdown='1'>Visit our [developers](developers.md) page and our [GitHub](https://github.com/yggdrasil-network/yggdrasil-go). Report bugs and problems to us as [GitHub Issues](https://github.com/yggdrasil-network/yggdrasil-go/issues).</p>
    </div>
</div>