|
@@ -1,5 +1,3 @@
|
|
|
-
|
|
|
|
|
-
|
|
|
|
|
<p align="center">
|
|
<p align="center">
|
|
|
<img src="netmaker.png"><break/>
|
|
<img src="netmaker.png"><break/>
|
|
|
</p>
|
|
</p>
|
|
@@ -52,20 +50,28 @@ In future releases, we have plans to support other platforms such as Windows and
|
|
|
#### Prereqs:
|
|
#### Prereqs:
|
|
|
1. A server with an IP reachable by your computers (a small ec2 instance or droplet would do just fine).
|
|
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).
|
|
2. Linux installed on the above server (we use Ubuntu, but anything that runs Docker should work).
|
|
|
-3. Install Docker (can run without Docker as well, but is not preferred. If this is a requirement, view the Advanced Usage docs).
|
|
|
|
|
|
|
+3. Install Docker if running in Docker Mode (see below).
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Launch Netmaker:
|
|
#### 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=3.231.219.63 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).
|
|
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 ofthat machine.
|
|
|
|
|
|
|
+2. In docker-compose.yml, change BACKEND_URL to the public IP of your server.
|
|
|
3. Run `sudo docker-compose up`
|
|
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.
|
|
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
|
|
5. Create a new admin user
|
|
|
-6. . Click "Create Network" and fill out the details
|
|
|
|
|
-7. You are now ready to begin using Netmaker. Create a key or enable manual node sign up so that your nodes can connect.
|
|
|
|
|
|
|
+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 :
|
|
#### On your machines :
|
|
|
-Run the following: `curl -sfL https://raw.githubusercontent.com/gravitl/netmaker/v0.1/netclient-install.sh | SERVER_URL=<your server ip>:50051 NET_NAME=<your network name> KEY=<your access key> sh -`
|
|
|
|
|
|
|
+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)
|
|
(Note: Key can be left out if manual node signup is enabled)
|
|
|
|
|
|
|
|
#### LICENSE
|
|
#### LICENSE
|
|
@@ -76,4 +82,3 @@ Netmaker's source code and all artifacts in this repository are freely available
|
|
|
|
|
|
|
|
Email: [email protected]
|
|
Email: [email protected]
|
|
|
Discord: https://discord.gg/zRb9Vfhk8A
|
|
Discord: https://discord.gg/zRb9Vfhk8A
|
|
|
-
|
|
|
afeiszli