VPN Network Service - Netmaker makes networks with WireGuard. Netmaker automates fast, secure, and distributed virtual networks.
#nebula #tailscale #mesh #vpn #golang #go #overlay #meshvpn

0xdcarns 0c1762e31d fixed test based on new logic 3 years ago
.github 2cbb9a1734 netclient docker workflow 3 years ago
auth 43b9e73eaa updated ioutil refs and composes 3 years ago
compose 4da76cf910 updating docker compose files 3 years ago
config ec3d1c035f Merge branch 'develop' into feature_v0.10.0_initialize_iptables 3 years ago
controllers 0c1762e31d fixed test based on new logic 3 years ago
database ad79f2ea1f addresses review comments 3 years ago
docker 06430a6932 updates for netclient docker images 3 years ago
docs 36cb6969eb docs: fix wrong path 3 years ago
functions 2cbf08ad1e adding logic for key checks, OS on server 3 years ago
grpc 44d03f6805 began refactoring of client 4 years ago
kube 0bc3014f10 fixed versions 3 years ago
logger a1566bc5f0 changed to range 3 years ago
logic 51fa553df3 removed default master key and added warning log if not set 3 years ago
models 9400209d97 adding OS and Version 3 years ago
mq 20adc73e2a revert 3 years ago
netclient d9a334b30c added initial pull to handle faster restarts 3 years ago
nginx 39e4d5377c updating docs 4 years ago
scripts 4ab924af3e use main.version rather than subpackage variables 3 years ago
servercfg 51fa553df3 removed default master key and added warning log if not set 3 years ago
serverctl 5cc6507a0c made use of string builder in logger 3 years ago
test a172641cad updating README 3 years ago
validation 8f72ecbaa0 refactored logic 3 years ago
.dockerignore 974627a9ab reorg of dockerfiles 3 years ago
.gitignore bc54bbf167 manual rebase to develop 3 years ago
CONTRIBUTING.md 95659ef0a5 Create CONTRIBUTING.md 3 years ago
Dockerfile 966603d3d0 match case of workflow var 3 years ago
LICENSE.txt 375482c16d updating docs 4 years ago
README.md 2b62731130 update readme gif 3 years ago
SECURITY.md d53bfd6ab1 Update SECURITY.md 3 years ago
go.mod 6f0950792f set retained true on server publish and client ping server on checkin 3 years ago
go.sum 6f0950792f set retained true on server publish and client ping server on checkin 3 years ago
main.go 51fa553df3 removed default master key and added warning log if not set 3 years ago
mesh-diagram.png 0bacbd9f6c first commit 4 years ago
netmaker.png ba711d1b39 Add files via upload 4 years ago

README.md

Create and control automated virtual networks.

WireGuard® Automation from Homelab to Enterprise

  • Peer-to-Peer Mesh Networks
  • Kubernetes and Multi-Cloud Enablement
  • Remote Site Access via Gateway
  • OAuth and Private DNS Features
  • Support for Linux, Mac, Windows, FreeBSD, iPhone, and Android

Get Started in 5 Minutes

For DigitalOcean, use the 1-Click App:
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, 80, 53, and 51821-51830/udp on the VM firewall and in cloud security settings.
  3. Run the script (see below for optional configurations):

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

Upon completion, the logs will display the instructions to connect various devices. These can also be retrieved from the UI under "Access Keys."

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).
wget -qO - https://raw.githubusercontent.com/gravitl/netmaker/master/scripts/nm-quick.sh | sudo bash -s -- -v true -c 10

Specify Domain and Email
Make sure your wildcard domain is pointing towards the server ip.
wget -qO - https://raw.githubusercontent.com/gravitl/netmaker/master/scripts/nm-quick.sh | sudo 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 Projects

Disclaimer

WireGuard is a registered trademark of Jason A. Donenfeld.

License

Netmaker's source code and all artifacts in this repository are freely available. All versions are published under the Server Side Public License (SSPL), version 1, which can be found here: LICENSE.txt.