gravitl/netmaker
1
1
Fork 0
mirror of https://github.com/gravitl/netmaker.git synced 2024-11-10 17:48:25 +08:00
Code Issues Projects Releases Packages Wiki Activity
Netmaker makes networks with WireGuard. Netmaker automates fast, secure, and distributed virtual networks.
333 commits 1398 branches 80 tags 273 MiB
Go 92.2%
Shell 7.8%
Find a file
afeiszli 7861e9e1e5 installer updates
2021-05-04 03:01:03 +00:00
.github/workflows add test branch PR and manual gen of docker images 2021-04-25 09:59:41 -04:00
config installer updates 2021-05-04 03:01:03 +00:00
controllers fixing address validation 2021-04-27 23:22:52 -04:00
docs Update USAGE.md 2021-04-22 07:50:01 -04:00
functions installer updates 2021-05-04 03:01:03 +00:00
grpc gateway works but local address not being set to endpoint. 2021-04-17 12:13:26 -04:00
models fixing address choosing 2021-04-27 23:40:01 -04:00
mongoconn massive number of changes to schema and error handling. 2021-04-13 00:42:35 -04:00
netclient fixed constant peer update issue 2021-04-19 10:49:52 -04:00
scripts installer updates 2021-05-04 03:01:03 +00:00
serverctl iptables now being set by client 2021-04-15 09:48:14 -04:00
test fixed validation 2021-04-27 22:08:28 -04:00
.gitignore first commit 2021-03-25 12:17:52 -04:00
defaultvalues.sh hotfixes for repo. Now works. 2021-03-25 22:29:36 -04:00
docker-compose.yml updated usage docs and install methods 2021-04-20 08:34:58 -04:00
Dockerfile updated usage docs and install methods 2021-04-20 08:34:58 -04:00
go.mod created dns api but no testing yet 2021-04-26 23:39:15 -04:00
go.sum created dns api but no testing yet 2021-04-26 23:39:15 -04:00
group_test.go updating tests 2021-04-19 11:02:59 -04:00
LICENSE.txt updating docs 2021-04-14 13:16:56 -04:00
main.go fixed JWT token auth 2021-04-20 01:50:58 +00:00
mesh-diagram.png first commit 2021-03-25 12:17:52 -04:00
netmaker.png Add files via upload 2021-03-29 15:18:51 -04:00
README.md Update README.md 2021-04-20 13:48:07 -04:00

README.md

Connect any computers together over a secure, fast, private network, and manage multiple networks from a central server.

What is Netmaker?

Netmaker is a tool for creating and managing virtual networks. The goal is to provide functionality similar to Tailscale, ZeroTier, and Nebula, but faster, easier, and more dynamic. It should be like clicking a button. Netmaker consists of a server, an agent, and a UI. You spin up the Netmaker server and then install netclient (the agent) on your computers. Netmaker will do the rest. It will tell all of your computers how to reach each other and will keep them informed of any changes to the network.

Netmaker's handy dandy UI can be found here.

Under the hood, Netmaker uses WireGuard to create encrypted tunnels between every node in your virtual network, creating a full mesh overlay. Netmaker takes the work out of manually configuring machines with WireGuard and updating them every time you have a change in your network. The netclient agent is self-updating and pulls any necessary changes (such as new peers) from the server.

Why Netmaker?

  1. Create a flat, secure network between multiple/hybrid cloud environments
  2. Integrate central and edge services
  3. Secure a home or office network while providing remote connectivity
  4. Manage cryptocurrency proof-of-stake machines
  5. Provide an additional layer of security on an existing network
  6. Encrypt Kubernetes inter-node communications
  7. Secure site-to-site connections

Compatible Systems

Netmaker works on most linux systems that have systemd. It works with Fedora, Ubuntu, and Raspian. Just make sure you have WireGuard installed. Having a problem? Open an issue or Contact us.

In future releases, we have plans to support other platforms such as Windows and MacOS.

Docs

For more information, please read the docs, or check out the Quick Start below:

Quick Start

Intro/Overview Video Tutorial
Site-to-Site Video Tutorial

Prereqs:

  1. A server with an IP reachable by your computers (a small ec2 instance or droplet would do just fine).
  2. Linux installed on the above server (we use Ubuntu, but anything that runs Docker should work).
  3. Install Docker if running in Docker Mode (see below).

Launch Netmaker:

Netmaker v0.2 introduces the server as a 'client'. This means the server can add itself into networks if you would like. To do so, Netmaker requires privileged access where it is running, and needs to modify the host filesystem. To run in this mode, we are not currently using Docker.

If you would like to run with "client mode", you can use the following script to deploy: sudo curl -sfL https://raw.githubusercontent.com/gravitl/netmaker/v0.2/netmaker-install-clientmode.sh | sudo SERVER_DOMAIN=< your server IP > sh -

If you would like to run without "client mode", and manually add/remove the server from networks:

  1. Clone this repo or just copy contents of "docker-compose.yml" to your Netmaker server (from prereqs).
  2. In docker-compose.yml, change BACKEND_URL to the public IP of your server.
  3. Run sudo docker-compose up
  4. Navigate to your server's IP in the browser and you should see the Netmaker UI asking to create a new admin user.
  5. Create a new admin user
  6. You are now ready to begin using Netmaker. There should be a default network you can use or you can create your own. Then, Create a key or enable manual node sign up so that your nodes can connect.

On your machines :

A command will be displayed when you generate a token for signing up nodes. Run it on each machine you would like to connect. curl -sfL https://raw.githubusercontent.com/gravitl/netmaker/v0.2/netclient-install.sh | KEY=<your access key> sh -
(Note: Key can be left out if manual node signup is enabled)

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.

CONTACT

Email: info@gravitl.com
Discord: https://discord.gg/zRb9Vfhk8A