From c05d4be955763d6c61e5a50bcd9d589d940c5e96 Mon Sep 17 00:00:00 2001 From: Neil Alexander Date: Sat, 24 Sep 2022 15:14:06 +0100 Subject: [PATCH] Update installation pages --- installation-linux-deb.md | 40 ++++++++++++++++--------------------- installation-linux-other.md | 10 ---------- installation-linux-rpm.md | 28 +++----------------------- 3 files changed, 20 insertions(+), 58 deletions(-) diff --git a/installation-linux-deb.md b/installation-linux-deb.md index 89c103e..299d9e1 100644 --- a/installation-linux-deb.md +++ b/installation-linux-deb.md @@ -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. diff --git a/installation-linux-other.md b/installation-linux-other.md index 1bb0172..a73b9a2 100644 --- a/installation-linux-other.md +++ b/installation-linux-other.md @@ -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 diff --git a/installation-linux-rpm.md b/installation-linux-rpm.md index 11fc674..e02266f 100644 --- a/installation-linux-rpm.md +++ b/installation-linux-rpm.md @@ -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 ```