cwinfo/yggdrasil-network.github.io
5
0
Fork 0
mirror of https://github.com/cwinfo/yggdrasil-network.github.io.git synced 2024-11-10 03:20:25 +00:00
Code Releases Activity

Merge pull request #64 from ThomasLeister/doc-update-rpm-manual

Browse Source 
Updates RPM manual: Adds COPR repo for Yggdrasil
This commit is contained in:
Neil Alexander 2020-05-17 13:54:34 +01:00 committed by GitHub
commit a4d523d367
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 39 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
installation-linux-rpm.md
View File

@ -10,44 +10,52 @@ sitemap: true
RPM binary packages exist to simplify the installation of Yggdrasil. These RPM binary packages exist to simplify the installation of Yggdrasil. These
will also work on any other RPM-based distribution. will also work on any other RPM-based distribution.
## Package install from the S3 repository
To start with, import the repository key to your `gpg` keyring and export it ## Install RPM package from COPR repository
to your `rpm` keyring:
``` There's a [Fedora COPR repository](https://copr.fedorainfracloud.org/coprs/leisteth/yggdrasil/) available, which provides recent versions of Yggdrasil - *not only for Fedora, but also for CentOS/RHEL!*
gpg --fetch-keys https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/deb/key.txt
gpg --armor --no-comment --export-options export-minimal --export 569130E8CA20FBC4CB3FDE555898470A764B32C9 | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-yggdrasil
### Fedora
Installation on Fedora is easy as:
```bash
dnf copr enable leisteth/yggdrasil
dnf install yggdrasil
``` ```
Add the repository: ... and you're ready to go!
### CentOS / RHEL
Paste the following into a new file `/etc/yum.repos.d/yggdrasil.repo`:
``` ```
echo '[yggdrasil] [leisteth-yggdrasil]
name = Yggdrasil name=Copr repo for yggdrasil owned by leisteth
baseurl = https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/rpm/ baseurl=https://copr-be.cloud.fedoraproject.org/results/leisteth/yggdrasil/epel-7-$basearch/
type=rpm-md
skip_if_unavailable=True
gpgcheck=1 gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-yggdrasil' | sudo tee /etc/yum.repos.d/yggdrasil.repo gpgkey=https://copr-be.cloud.fedoraproject.org/results/leisteth/yggdrasil/pubkey.gpg
repo_gpgcheck=0
enabled=1
enabled_metadata=1
``` ```
Create the `yggdrasil` group on your system: *Don't forget to change the `baseurl` according to your RHEL/CentOS version! In the config above, version 7 is used.*
```
sudo groupadd --system yggdrasil Install yggdrasil:
```bash
yum update
yum install yggdrasil
``` ```
Install Yggdrasil:
```
sudo dnf install yggdrasil
```
Configuration will be generated automatically into `/etc/yggdrasil.conf` when
the package is installed, and the Yggdrasil service will automatically be
installed into `systemd`.
Enable and start the service after install/upgrade: ## One-off package install from CircleCI (not recommended!)
```
sudo systemctl enable yggdrasil
sudo systemctl start yggdrasil
```
## One-off package install from CircleCI
Visit our [Builds](builds.md) page and download the relevant `.rpm` file, then Visit our [Builds](builds.md) page and download the relevant `.rpm` file, then
install it on your system: install it on your system:
@ -59,6 +67,9 @@ Configuration will be generated automatically into `/etc/yggdrasil.conf` when
the package is installed, and the Yggdrasil service will automatically be the package is installed, and the Yggdrasil service will automatically be
installed into systemd and started. installed into systemd and started.
**Please note: By using this installation method, you won't receive (security-/) updates for Yggdrasil!**
## Making configuration changes ## Making configuration changes
Modify the `/etc/yggdrasil.conf` file and then either reload the config: Modify the `/etc/yggdrasil.conf` file and then either reload the config: