nebula icon indicating copy to clipboard operation
nebula copied to clipboard

[Documentation] Nebula without lighthouses?

Open nh2 opened this issue 3 years ago • 5 comments

I would like the documentation to clarify:

  • If all involved nodes have fixed IPs and there are no firewalls involved, can Nebula be run without lighthouses?

That is, is it a legitimate/supported config to just list all nodes in all configs' static_host_map?

Is there be any drawback from such a setup?

Thanks!

nh2 avatar Feb 13 '22 12:02 nh2

Yes, you could statically list everything in the static_host_map. The only drawback is the obvious - you cannot roam easily, and all nodes will require a full list of other hosts. it is a bit like using /etc/hosts exclusively instead of DNS

rawdigits avatar Feb 15 '22 11:02 rawdigits

That sounds great. The startup warning already hints it's possible:

WARN[0000] No lighthouses.hosts configured, this host will only be able to initiate tunnels with static_host_map entries

It would be great if this could be generally explained in the docs.

nh2 avatar Feb 15 '22 15:02 nh2

@nh2 Hello! Have you had success running with this setup? Does adding/removing entries requires downtime?

michaelr524 avatar Aug 10 '22 13:08 michaelr524

@michaelr524 The static_host_map is reloadable (with a HUP signal to the running Nebula process) starting with Nebula 1.6.0.

brad-defined avatar Aug 10 '22 13:08 brad-defined

Thank you! @brad-defined

michaelr524 avatar Aug 10 '22 13:08 michaelr524

Since it seems this question has been answered I am going to close the issue out. The Nebula docs repo is public if you'd like to submit a PR to explain this behavior: https://github.com/DefinedNet/nebula-docs

johnmaguire avatar Dec 07 '22 18:12 johnmaguire

@michaelr524 I've been running without lighthouses since February, also on Nebula 1.4 without hot reloading.

When I change the host map, I just do a rolling restart of my hosts, and even though that stops the VPN momentarily, this doesn't cause any downtimes to the service I'm building on top.

nh2 avatar Dec 07 '22 19:12 nh2