Skip to content

Latest commit

 

History

History
53 lines (38 loc) · 2.22 KB

README.md

File metadata and controls

53 lines (38 loc) · 2.22 KB

Summary

Nebula is a networking overlay tool made by Slack. This repo is creating rpm packages of it.

Copr build status

This repository is primarily created for my own personal use, but if it is useful for others, good on them.

Details

Nebula is a networking overlay tool that lets you connect computers in a way similar to Tinc or Wireguard.

There exist multiple other projects that are also named "nebula", so choosing "nebula-overlay-networking" to avoid naming collisions as well as being a bit more descriptive than just "nebula".

Rpm package

For now I lazily download and use the precompiled upstream release binaries. Long term I should maybe compile the go source files properly, however as a benefit it is now trivially simple to verify that the binaries I provide in this package are 100% exactly the same as the upstream project releases.

The package installs the binaries obviously. In addition it contains

  • a nebula firewalld service definition (UDP 4242) that is permanently added to the public zone on package install and removed on package removal.
  • a systemd service file. The service is not started or enabled on package install (it does not make sense to do that before configuration is done).

Installation example

dnf install nebula-overlay-networking
cd /etc/nebula
${EDITOR:-nano} config.yml

git add config.yml                   # Of course you are using etckeeper, right?
git commit -m "Configured nebula"    # https://etckeeper.branchable.com/

systemctl start nebula
systemctl status nebula
systemctl enable nebula

git add /etc/systemd/system/multi-user.target.wants/nebula.service
git commit -m "Enabled nebula service" -m "systemctl enable nebula"