cwinfo/yggdrasil-network.github.io
5
0
Fork 0
mirror of https://github.com/cwinfo/yggdrasil-network.github.io.git synced 2024-11-09 23:50:26 +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
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
to your `rpm` keyring:
```
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
## Install RPM package from COPR repository
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!*
### 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]
name = Yggdrasil
baseurl = https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/rpm/
[leisteth-yggdrasil]
name=Copr repo for yggdrasil owned by leisteth
baseurl=https://copr-be.cloud.fedoraproject.org/results/leisteth/yggdrasil/epel-7-$basearch/
type=rpm-md
skip_if_unavailable=True
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:
```
sudo groupadd --system yggdrasil
*Don't forget to change the `baseurl` according to your RHEL/CentOS version! In the config above, version 7 is used.*
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:
```
sudo systemctl enable yggdrasil
sudo systemctl start yggdrasil
```
## One-off package install from CircleCI
## 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:
@ -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
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: