2019-03-15 17:32:23 +00:00
---
tags: dontlink
sitemap: true
---
2019-03-15 18:27:41 +00:00
# Installing on Red Hat Enterprise Linux, Fedora, CentOS and similar
**These instructions apply to any RPM-based distribution with `systemd` .**
2019-03-15 17:32:23 +00:00
RPM binary packages exist to simplify the installation of Yggdrasil. These
will also work on any other RPM-based distribution.
2019-06-02 15:43:10 +00:00
## 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
2019-03-15 17:32:23 +00:00
```
2019-06-02 15:43:10 +00:00
... and you're ready to go!
### CentOS / RHEL
Paste the following into a new file `/etc/yum.repos.d/yggdrasil.repo` :
2019-03-15 17:32:23 +00:00
```
2019-06-02 15:43:10 +00:00
[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
2019-03-15 17:32:23 +00:00
gpgcheck=1
2019-06-02 15:43:10 +00:00
gpgkey=https://copr-be.cloud.fedoraproject.org/results/leisteth/yggdrasil/pubkey.gpg
repo_gpgcheck=0
enabled=1
enabled_metadata=1
2019-03-15 17:32:23 +00:00
```
2019-06-02 15:43:10 +00:00
*Don't forget to change the `baseurl` according to your RHEL/CentOS version! In the config above, version 7 is used.*
2019-03-15 17:32:23 +00:00
2019-06-02 15:43:10 +00:00
Install yggdrasil:
2019-03-15 17:32:23 +00:00
2019-06-02 15:43:10 +00:00
```bash
yum update
yum install yggdrasil
2019-03-15 17:32:23 +00:00
```
2019-06-02 15:43:10 +00:00
## One-off package install from CircleCI (not recommended!)
2019-03-15 17:32:23 +00:00
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.
2019-06-02 15:43:10 +00:00
**Please note: By using this installation method, you won't receive (security-/) updates for Yggdrasil!**
2019-03-15 17:44:04 +00:00
## Making configuration changes
2019-03-15 17:32:23 +00:00
Modify the `/etc/yggdrasil.conf` file and then either reload the config:
```
systemctl reload yggdrasil
```
... or restart the Yggdrasil daemon altogether:
```
systemctl restart yggdrasil
```
2019-03-15 17:44:04 +00:00
## After installation
2019-03-15 17:32:23 +00:00
Read the [Linux platform page ](platform-linux.md ) page for further
information about Linux platform support.
