slackhq /nebula

A scalable overlay networking tool with a focus on performance, simplicity and security

★ 18,532⑂ 1,204👁 229⑃ 1,290● 644▤ 31
GoMITCreated 2019-11-16
Download: Release v1.12.0Release-1.12.0 ↓1.12.02026-10-29
+3
Daily
+32
Weekly
+100
Monthly
18,532
stars
1,204
forks
229
watchers
1,290
prs
644
issues
31
releases

README

What is Nebula?
Nebula is a scalable overlay networking tool with a focus on performance, simplicity and security.
It lets you seamlessly connect computers anywhere in the world. Nebula is portable, and runs on Linux, OSX, Windows, iOS, and Android.
It can be used to connect a small number of computers, but is also able to connect tens of thousands of computers.

Nebula incorporates a number of existing concepts like encryption, security groups, certificates,
and tunneling.
What makes Nebula different to existing offerings is that it brings all of these ideas together,
resulting in a sum that is greater than its individual parts.

Further documentation can be found here.

You can read more about Nebula here.

You can also join the NebulaOSS Slack group here.

 Supported Platforms

 Desktop and Server

Check the releases page for downloads or see the Distribution Packages section.

- Linux - 64 and 32 bit, arm, and others
- Windows
- MacOS
- Freebsd

 Distribution Packages

- Arch Linux
    sh
    sudo pacman -S nebula
    

- Fedora Linux
    sh
    sudo dnf install nebula
    

- Debian Linux
    sh
    sudo apt install nebula
    

- Alpine Linux
    sh
    sudo apk add nebula
    

- macOS Homebrew
    sh
    brew install nebula
    

- Docker
    sh
    docker pull nebulaoss/nebula
    

 Mobile (source code)

- iOS
- Android

 Technical Overview

Nebula is a mutually authenticated peer-to-peer software-defined network based on the Noise Protocol Framework.
Nebula uses certificates to assert a node's IP address, name, and membership within user-defined groups.
Nebula's user-defined groups allow for provider agnostic traffic filtering between nodes.
Discovery nodes (aka lighthouses) allow individual peers to find each other and optionally use UDP hole punching to establish connections from behind most firewalls or NATs.
Users can move data between nodes in any number of cloud service providers, datacenters, and endpoints, without needing to maintain a particular addressing scheme.

Nebula uses Elliptic-curve Diffie-Hellman (ECDH) key exchange and AES-256-GCM in its default configuration.

Nebula was created to provide a mechanism for groups of hosts to communicate securely, even across the internet, while enabling expressive firewall definitions similar in style to cloud security groups.

 Getting started (quickly)

Don't want to manage your own PKI and lighthouses? Managed Nebula from Defined Networking handles all of this for you.

To set up a Nebula network, you'll need:

 1. The Nebula binaries or Distribution Packages for your specific platform. Specifically you'll need nebula-cert and the specific nebula binary for each platform you use.

 2. (Optional, but you really should..) At least one discovery node with a routable IP address, which we call a lighthouse.

Nebula lighthouses allow nodes to find each other, anywhere in the world. A lighthouse is the only node in a Nebula network whose IP should not change. Running a lighthouse requir

Top issues

Discussions

Latest release

Release v1.12.0 v1.12.0 2026-10-29
This release introduces udp/tun offloading support that can be enabled for greater performance. This will be enabled by default in a future release. See the listen.udp_offloads and tun.use_offloads example config settings for more details.

See the v1.12.0 milestone for a complete list of changes.

 Breaking

- Building Nebula, or embedding it as a library, now requires go v1.27.3. (1940, 2028)
- A firewall rule group that YAML reads as a float, a date, a map, or a nested array is now rejected on startup and
  reload instead of being quietly converted to a string, group: 1.10 used to m

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON