5
0
mirror of https://github.com/cwinfo/yggdrasil-network.github.io.git synced 2024-09-20 00:12:32 +00:00
yggdrasil-network.github.io/index.md

30 lines
3.0 KiB
Markdown
Raw Normal View History

2018-03-11 21:22:45 +00:00
---
tags: dontlink
---
2018-03-06 17:39:25 +00:00
# Introduction
2018-03-06 14:02:44 +00:00
2018-05-08 23:19:32 +00:00
Yggdrasil is an early-stage implementation of a fully end-to-end encrypted IPv6 network. It is lightweight, self-arranging, supported on multiple platforms and allows pretty much any IPv6-capable application to communicate securely with other Yggdrasil nodes.
2018-06-01 01:51:40 +00:00
Although Yggdrasil shares many similarities with [cjdns](https://github.com/cjdelisle/cjdns), it employs a different routing algorithm based on a globally-agreed spanning tree and greedy routing in a metric space. In theory, an Yggdrasil network should scale well on networks with internet-like topologies. Take a look at the [About](about.md) page for a detailed overview.
2018-03-06 14:02:44 +00:00
2018-03-06 17:39:25 +00:00
## Project Status
2018-03-06 17:36:02 +00:00
2018-06-13 18:31:21 +00:00
The project is currently in very early stages but it is being actively developed. We are currently at [version 0.2](https://github.com/yggdrasil-network/yggdrasil-go/milestone/1), which is our first major alpha release. Yggdrasil is considered to be alpha quality at this point. It is entirely possible that breaking changes may still happen but generally it works well and has proven to be reasonably stable so far, with recent builds reaching weeks of uptime without crashes or failures.
2018-03-06 17:36:02 +00:00
2018-03-13 12:42:49 +00:00
Currently we don't have any specific releases, but binaries are [automatically built](https://circleci.com/gh/yggdrasil-network/yggdrasil-go) each time that we commit to the Git repository for a number of platforms. Feel free to [download them](builds.md), play with them, stress-test them or even use them in your own environments. However, be prepared to upgrade frequently and we wouldn't recommend relying on Yggdrasil for anything mission-critical at this stage!
2018-03-06 17:36:02 +00:00
2018-05-08 23:19:32 +00:00
A small number of users have been using and stress-testing Yggdrasil quite heavily for a number of purposes, including but not limited to secure remote access (SSH and VNC), access to Matrix, Jabber and IRC servers (including a Matrix-IRC bridge that runs solely over Yggdrasil) and even some large file transfers and performance tests.
2018-03-06 17:39:25 +00:00
## Implementation
2018-03-06 17:36:02 +00:00
2018-03-11 21:22:45 +00:00
Yggdrasil is written in Go. The codebase is fairly small and easy to navigate. It has been tested on a number of platforms (including Linux, Windows, macOS, NetBSD, FreeBSD, OpenBSD and Ubiquiti EdgeOS) although with various minor caveats. See the [Platforms](platforms.md) page for more information.
2018-03-06 17:48:51 +00:00
## Get Involved
2018-05-08 23:19:32 +00:00
If you are interested in or would like to get involved in the Yggdrasil project, please feel free to join us!
2018-03-06 17:48:51 +00:00
- Come and chat to us in our [Matrix channel](https://matrix.to/#/#yggdrasil:matrix.org) (or even [read our channel backlog](https://view.matrix.org/room/!DwmKuvGvRKciqyFcxv:matrix.org/))
2018-06-03 19:37:25 +00:00
- Alternatively, come and chat to us on the [Freenode IRC network](irc://chat.freenode.net/yggdrasil) in `#yggdrasil`.
2018-05-08 23:19:32 +00:00
- Take a look at our [GitHub](https://github.com/yggdrasil-network/yggdrasil-go), and in particular, the [Open Issues](https://github.com/yggdrasil-network/yggdrasil-go/issues) which contain bugs waiting to be fixed, problems waiting to be solved and plenty of in-depth discussions about our implementation or design choices