+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 requirTop issues
#637Unable to achieve 10 Gbit/s throughput on Hetzner server35 comments · 2022-02-13#1014Feature request: Support UDP/TCP port fowarding to a host without setting up a tun30 comments · 2023-11-15#1868🐛 BUG: HostQuery fails to resolve underlay addresses for secondary overlay IPs in dual-stack certs (`udpAddrs=[]`)21 comments · 2026-09-02#889🐛 BUG: host won't reconnect to lighthouse successfully behind a ip-changed NAT17 comments · 2023-06-03#680Using unsafe routes with Windows or macOS exit node15 comments · 2022-05-19#909🐛 BUG:Nebula cannot obtain the correct dns server address from the system12 comments · 2023-06-21#1446Feature Request: Post-quantum cryptography11 comments · 2025-08-05#1480Feature request: relay traffic to unsafe routes to another peer (for running Kubernetes over Nebula)9 comments · 2025-09-25
Discussions
#2048De-google Option Request1 comments · 2026-11-08#1997Can't connect a smartphone to the mesh using only a QR-code scan ?1 comments · 2026-10-22#1941how to set dns resolver for nebula tun interface1 comments · 2026-10-15#1934lighthouse high-availability with redundancy1 comments · 2026-10-13#1927Nebula abysmal performance and random stalling of traffic2 comments · 2026-10-09#1921lighthouse as relay for other lighthouse1 comments · 2026-10-08#1836An incorrect DNS configuration on tun adapter is affecting the physical network card's ability to connect to the Internet properly.1 comments · 2026-07-28#1780Hi everyone, I made a GUI for Nebula1 comments · 2026-07-04
Latest release
Release v1.12.0 v1.12.0 2026-10-29This 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