gravitl/netmaker repository overview

Create and control automated virtual networks.

⁠ ⁠ ⁠ ⁠ ⁠ ⁠

⁠WireGuard® Automation from Homelab to Enterprise

• Peer-to-Peer Mesh Networks
• Kubernetes, Multi-Cloud
• OAuth and Private DNS
• Linux, Mac, Windows, iPhone, and Android

⁠Get Started in 5 Minutes

For production-grade installations, visit the Install Docs⁠.
For an HA install using helm on k8s, visit the Helm Repo⁠.

1. Get a cloud VM with Ubuntu 20.04 and a public IP.
2. Open ports 443, 53, and 51821-51830/udp on the VM firewall and in cloud security settings.
3. Run the script (see below for optional configurations):

sudo wget -qO - https://raw.githubusercontent.com/gravitl/netmaker/develop/scripts/nm-quick.sh | bash

Upon completion, the logs will display a script that can be used to automatically connect Linux and Mac devices. It will also display instructions for Windows, iPhone, and Android.

After installing Netmaker, check out the Walkthrough⁠ and Getting Started⁠ guides to learn more about configuring networks. Or, check out some of our other Tutorials⁠ for different use cases, including Kubernetes.

⁠Optional configurations

Deploy a "Hub-And-Spoke VPN" on the server
This will configure a standard VPN (non-meshed) for private internet access, with 10 clients (-c).
sudo wget -qO - https://raw.githubusercontent.com/gravitl/netmaker/develop/scripts/nm-quick.sh | bash -s -- -v true -c 10

Specify Domain and Email
Make sure your wildcard domain is pointing towards the server ip.
sudo wget -qO - https://raw.githubusercontent.com/gravitl/netmaker/develop/scripts/nm-quick.sh | bash -s -- -d mynetmaker.domain.com -e [email protected]

Script Options

./nm-quick
-d domain.example.com # specify a wildcard domain for netmaker to use (DNS must point to this server)
-e [email protected] # specify your email (for SSL certificates)
-m true # create a default 'mesh network' (on by default)
-v false # create a default 'VPN network' (off by default)
-c 7 # number of client configs to create (for VPN network, 5 by default)

⁠Why Netmaker + WireGuard?

• Netmaker automates virtual networks between data centers, clouds, and edge devices, so you don't have to.

• Kernel WireGuard offers maximum speed, performance, and security.

• Netmaker is built to scale from the small business to the enterprise.

• Netmaker with WireGuard can be highly customized for peer-to-peer, site-to-site, Kubernetes, and more.

⁠Get Support

• Community (Discord)⁠

• Business (Subscription)⁠

• Learning Resources⁠

⁠Disclaimer

WireGuard⁠ is a registered trademark of Jason A. Donenfeld.