cwinfo/yggdrasil-network.github.io
5
0
Fork 0
mirror of https://github.com/cwinfo/yggdrasil-network.github.io.git synced 2024-09-08 00:24:33 +00:00
Code Releases Activity

Update installation pages

Browse Source
This commit is contained in:
Neil Alexander 2022-09-24 15:14:06 +01:00
parent 832b72e1e6
commit c05d4be955
No known key found for this signature in database
GPG Key ID: A02A2019A2BB0944
3 changed files with 20 additions and 58 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
installation-linux-deb.md
View File

@ -11,6 +11,19 @@ Yggdrasil is supported on Debian Linux. Debian binary packages exist to simplify
the installation of Yggdrasil. These will also work on any Debian-based
distribution, e.g. elementaryOS.
## One-off installation
Debian packages are built and are available in the [GitHub Releases](https://github.com/yggdrasil-network/yggdrasil-go/releases).
Install the package using `dpkg -i filename.deb`.
## Package install from your distribution
Some Debian-based distributions may have an `yggdrasil-go` package available in
their repositories:
```
sudo apt-get install yggdrasil
```
## Package install from the S3 repository
On some platforms, e.g. Raspberry Pi, you may need to start by installing
@ -39,6 +52,9 @@ Install Yggdrasil:
```
sudo apt-get install yggdrasil
```
## After installation
Configuration will be generated automatically into `/etc/yggdrasil.conf` when
the package is installed, and the Yggdrasil service will automatically be
installed into `systemd`.
@ -49,32 +65,10 @@ sudo systemctl enable yggdrasil
sudo systemctl start yggdrasil
```
## One-off package install from CircleCI
Visit our [Builds](builds.md) page and download the relevant `.deb` file, then
install it on your system. If you want to install the latest `.deb` from the
`master` branch:
```
curl -so- "https://circleci.com/api/v1.1/project/github/yggdrasil-network/yggdrasil-go/latest/artifacts?branch=master&filter=successful" | \
egrep -o "https.*yggdrasil\-.*$(dpkg --print-architecture).deb" | \
while read line; do curl -O $line && dpkg -i $(basename $line); done
```
Configuration will be generated automatically into `/etc/yggdrasil.conf` when
the package is installed, and the Yggdrasil service will automatically be
installed into systemd and started.
### Making configuration changes
Modify the `/etc/yggdrasil.conf` file and then either reload the config:
```
systemctl reload yggdrasil
```
... or restart the Yggdrasil daemon altogether:
To make configuration changes, modify the `/etc/yggdrasil.conf` file and then restart the Yggdrasil daemon:
```
systemctl restart yggdrasil
```
## After installation
Read the [Linux platform page](configuration.md) page for further
information about Linux platform support.

10
installation-linux-other.md
View File

@ -8,16 +8,6 @@ sitemap: true
Yggdrasil is supported on Linux. You can either [download the latest binary from
CircleCI](builds.md) or you can build from source.
## Download binaries
Download the relevant Linux `yggdrasil` and `yggdrasilctl` binaries from the
[Builds](builds.md) page.
Copy these into a suitable location:
```
sudo cp {yggdrasil,yggdrasilctl} /usr/local/bin
```
## Build from source
Linux has most of the tools needed to build Yggdrasil from source - you just

28
installation-linux-rpm.md
View File

@ -10,46 +10,24 @@ sitemap: true
RPM binary packages exist to simplify the installation of Yggdrasil. These
will also work on any other RPM-based distribution.
## Install RPM package from COPR repository
There's a [Fedora COPR repository](https://copr.fedorainfracloud.org/coprs/rany/yggdrasil/) available, which provides recent versions of Yggdrasil - *only for Fedora!*
There's a [Fedora COPR repository](https://copr.fedorainfracloud.org/coprs/neilalexander/yggdrasil-go/) available, which provides recent versions of Yggdrasil for some RPM-based distributions.
### Fedora
Installation on Fedora is easy as:
```bash
dnf copr enable rany/yggdrasil
dnf copr enable neilalexander/yggdrasil-go
dnf install yggdrasil
```
... and you're ready to go!
## One-off package install from CircleCI (not recommended!)
Visit our [Builds](builds.md) page and download the relevant `.rpm` file, then
install it on your system:
```
sudo groupadd --system yggdrasil
sudo rpm -i yggdrasil...rpm
```
Configuration will be generated automatically into `/etc/yggdrasil.conf` when
the package is installed, and the Yggdrasil service will automatically be
installed into systemd and started.
**Please note: By using this installation method, you won't receive (security-/) updates for Yggdrasil!**
## Making configuration changes
Modify the `/etc/yggdrasil.conf` file and then either reload the config:
```
systemctl reload yggdrasil
```
... or restart the Yggdrasil daemon altogether:
Modify the `/etc/yggdrasil.conf` file and then either restart the Yggdrasil daemon:
```
systemctl restart yggdrasil
```