slackhq

nebula: Build Secure Peer-to-Peer Overlay Networks

Nebula connects hosts across networks through an encrypted, certificate-based overlay, with group-based traffic rules and peer discovery. It suits teams that need secure connectivity across cloud, datacenter, and endpoint environments without relying on a fixed addressing scheme.

View on GitHub Compare
Stars
18.4k
Forks
1.2k
Stars, last 30 days
+92

Our take

Health score

64/100

How it is scored
Activity
62
Community
82
Issues
51
Pull requests
59

+92 stars in the last 30 days

  • Merges more pull requests than 84% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

18,544

Forks

1,205

Change since Nov 18, 2026: +4 stars·0 forks

Overview

Nebula is a Go-based overlay networking tool for connecting computers securely across the internet. It creates a mutually authenticated peer-to-peer network, so hosts can communicate across cloud providers, datacenters, and other networks without requiring a particular addressing scheme.

It is aimed at teams that want control over network identity and traffic policy. Certificates identify hosts and their groups, while lighthouses help peers discover one another and can support UDP hole punching through many firewalls and NATs.

Key Features

  • Encrypts peer connections using the Noise Protocol Framework, with ECDH and AES-256-GCM in the default configuration.
  • Uses certificates to identify hosts by IP address, name, and group membership.
  • Supports group-based traffic filtering across providers and environments.
  • Provides lighthouse nodes for peer discovery and optional UDP hole punching.
  • Runs on Linux, macOS, Windows, iOS, and Android, with desktop and server packages also listed for FreeBSD.
  • Includes nebula-cert for creating a certificate authority and signing host certificates.
  • Offers build targets for Go FIPS 140-3 mode and P256 cryptography for deployments with compliance requirements.

Use Cases

  • Teams connecting servers across multiple cloud providers or datacenters without maintaining a shared network address plan.
  • Administrators creating private connectivity between employee laptops and internal hosts, with access rules based on certificate groups.
  • Small organizations or individuals linking their own devices across home, office, and hosted networks.
  • Operators needing a self-managed peer network, or evaluating a managed option when they do not want to run their own PKI and lighthouses.

Getting Started

On Debian, install the package with:

sudo apt install nebula

A working network also needs host certificates and configuration. See the README and official documentation for setup details.

Alternatives

  • tailscale: Tailscale builds WireGuard-based private networks with integrated authentication, while Nebula uses certificate-based identities and group-based traffic rules.
  • EasyTier: EasyTier emphasizes decentralized VPN connectivity with NAT traversal and optional relays, while Nebula uses certificate-based identity and peer discovery.
ProjectLanguageLicenseStarsStatus
nebulaGoMIT18.4kNot checked yet
tailscaleGoBSD-3-Clause37.7kActive
EasyTierRustLGPL-3.013.9kActive

Considerations

  • Initial setup requires a certificate authority and host certificates. The CA private key is sensitive and must not be copied to individual nodes.
  • A lighthouse is optional, but the README recommends having at least one discovery node with a routable IP address for peer discovery.
  • Certificate authorities expire by default after one year, so deployments need a plan for renewal or rotation.
  • FIPS mode and P256 are available for compliance needs, but the README describes these as non-default options. BoringCrypto support is deprecated and is slated for removal in the next release.
  • Although the project supports several platforms, the available packages and installation steps differ by platform.

Found this useful?

Share it with someone who would like nebula.

Comparisons