Update Quickstart Guide
BIN
public/docs-static/img/getting-started/add-linux-peer.png
Normal file
|
After Width: | Height: | Size: 151 KiB |
|
Before Width: | Height: | Size: 164 KiB After Width: | Height: | Size: 215 KiB |
BIN
public/docs-static/img/getting-started/dashboard.png
Normal file
|
After Width: | Height: | Size: 284 KiB |
|
Before Width: | Height: | Size: 87 KiB After Width: | Height: | Size: 238 KiB |
BIN
public/docs-static/img/getting-started/mac-installation.png
Normal file
|
After Width: | Height: | Size: 66 KiB |
|
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 321 KiB |
BIN
public/docs-static/img/getting-started/setup-key-created.png
Normal file
|
After Width: | Height: | Size: 83 KiB |
BIN
public/docs-static/img/getting-started/setup-key.png
Normal file
|
After Width: | Height: | Size: 194 KiB |
BIN
public/docs-static/img/getting-started/systray-connected.png
Normal file
|
After Width: | Height: | Size: 62 KiB |
@@ -7,75 +7,103 @@ export const title = 'Getting Started'
|
|||||||
<div className="videowrapper">
|
<div className="videowrapper">
|
||||||
<iframe src="https://www.youtube.com/embed/JRCZy4rLi-c" allow="fullscreen;"></iframe>
|
<iframe src="https://www.youtube.com/embed/JRCZy4rLi-c" allow="fullscreen;"></iframe>
|
||||||
</div>
|
</div>
|
||||||
<br/>
|
|
||||||
This guide describes how to quickly get started with NetBird and create a secure private network with two connected machines.
|
This guide describes how to quickly get started with NetBird and create a secure private network with two connected machines.
|
||||||
|
For this tutorial we will use a Macbook and an EC2 node running Linux on AWS.
|
||||||
One machine is a Linux laptop, and the other one a EC2 node running on AWS.
|
|
||||||
Both machines are running Linux but NetBird also works on Windows, MacOS nad popular mobile platforms like Android and iOS.
|
|
||||||
|
|
||||||
## Create a NetBird Account
|
|
||||||
Sign-up at [app.netbird.io](https://app.netbird.io/)
|
|
||||||
You can use your Google, GitHub or Microsoft account.
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<img src="/docs-static/img/getting-started/auth.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## Install NetBird
|
## Install NetBird
|
||||||
|
|
||||||
After a successful login you will be redirected to the ```Peers``` screen which is empty because you don't have any peers yet.
|
NetBird works on almost any platform including Windows, macOS, Linux, iOS, Android, Docker, routers, and even serverless environments.
|
||||||
|
To get started, install NetBird on your laptop by following the instructions on the [installation page](https://app.netbird.io/install):
|
||||||
The `Add peer` window should automatically pop up, but if it doesn't, click ```Add new peer``` to add a new machine.
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<img src="/docs-static/img/getting-started/empty-peers.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Choose your machine operating system (in our case it is ```Linux```) and proceed with the installation steps.
|
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<img src="/docs-static/img/getting-started/add-peer.png" alt="login-to-netbird" className="imagewrapper"/>
|
<img src="/docs-static/img/getting-started/add-peer.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## Connect your Laptop
|
|
||||||
|
|
||||||
If you installed NetBird Desktop UI you can use it to connect to the network instead of running `netbird up` command.
|
|
||||||
Look for `NetBird` in your application list, run it, and click `Connect`.
|
|
||||||
>
|
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<img src="/docs-static/img/getting-started/systray.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
<img src="/docs-static/img/getting-started/mac-installation.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
At this point a browser window pops up starting a device registration process. Click confirm and follow the steps if required.
|
## Connect Your Laptop
|
||||||
|
NetBird comes with a Desktop UI application that can be found in the systray. If it hasn't automatically started, look
|
||||||
|
for `NetBird` in the application list, run it, and click `Connect`:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<img src="/docs-static/img/getting-started/systray.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<Note>
|
||||||
|
Alternatively, you can run the `netbird up` command in the terminal.
|
||||||
|
</Note>
|
||||||
|
|
||||||
|
At this point a browser window pops up starting an interactive SSO login session that will register your laptop.
|
||||||
|
You will be prompt to sign up and confirm your device registration:
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<img src="/docs-static/img/getting-started/device-confirmation.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
<img src="/docs-static/img/getting-started/device-confirmation.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## Connect Your EC2 Node
|
The NetBird systray icon will turn orange indicating that your laptop was registered in the network:
|
||||||
|
|
||||||
On the EC2 node repeat the installation steps and run `netbird up` command.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo netbird up
|
|
||||||
```
|
|
||||||
|
|
||||||
Copy the verification URL from the terminal output and paste it in your browser. Repeat step #5
|
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<img src="/docs-static/img/getting-started/netbird-up.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
<img src="/docs-static/img/getting-started/systray-connected.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## Validate Connection
|
## Confirm the Laptop Registration
|
||||||
|
|
||||||
Return to ```Peers``` and you should notice 2 new machines with status ```online```
|
After the registration is complete, proceed to the [NetBird dashboard](https://app.netbid.io) to confirm that your
|
||||||
|
laptop is in the network. You will see it in the `Peers` view:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<img src="/docs-static/img/getting-started/dashboard.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
||||||
|
|
||||||
|
</p>
|
||||||
|
|
||||||
|
## Install NetBird on the EC2 Node
|
||||||
|
|
||||||
|
Let's install NetBird on the server. In the `Peers` view, click `Add Peer` and choose Linux:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<img src="/docs-static/img/getting-started/add-linux-peer.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Copy the installation script and paste in the terminal of your EC2 node:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://pkgs.netbird.io/install.sh | sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## Connect the EC2 Node
|
||||||
|
|
||||||
|
In the previous steps you used the interactive SSO login flow to register a user device. This flow is a convenient way to
|
||||||
|
register devices with a user interface. However, for servers or containers that don't have a user interface,
|
||||||
|
you can use a [setup key](/how-to/register-machines-using-setup-keys) to register them.
|
||||||
|
|
||||||
|
To create a setup key, go to the `Setup Keys` section, click `Create Setup Key`, name your key, and click `Create`:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<img src="/docs-static/img/getting-started/setup-key.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<img src="/docs-static/img/getting-started/setup-key-created.png" alt="login-to-netbird" className="imagewrapper"/>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Copy the newly created setup key and use it with the `netbird up --setup-key <KEY>` command to connect your EC2 node to the network.
|
||||||
|
Run this command in the terminal of your EC2 node:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
netbird up --setup-key PASTE_YOUR_KEY_HERE
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validate the Connection
|
||||||
|
|
||||||
|
Return to the `Peers` view in the NetBird dashboard. You should see two machines in the list:
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<img src="/docs-static/img/getting-started/peers.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
<img src="/docs-static/img/getting-started/peers.png" alt="login-to-netbird" className="imagewrapper-big"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
To test the connection you could try pinging devices:
|
To test the connection ping the machines from each other:
|
||||||
|
|
||||||
On your laptop:
|
On your laptop:
|
||||||
```bash
|
```bash
|
||||||
@@ -84,13 +112,18 @@ ping ec2-demo-node.netbird.cloud
|
|||||||
|
|
||||||
On the EC2 node:
|
On the EC2 node:
|
||||||
```bash
|
```bash
|
||||||
ping my-linux-laptop.netbird.cloud
|
ping mikhails-macbook-pro.netbird.cloud
|
||||||
```
|
```
|
||||||
Done! You now have a secure peer-to-peer private network configured.
|
Done! You now have a secure peer-to-peer WireGuard connection between two machines.
|
||||||
|
|
||||||
<br/>
|
## Next Steps
|
||||||
|
|
||||||
- Make sure to [star us on GitHub](https://github.com/netbirdio/netbird)
|
Try creating a [network access policy](/how-to/manage-network-access) to control the traffic between the two machines.
|
||||||
|
|
||||||
|
|
||||||
|
## Support Us
|
||||||
|
|
||||||
|
- Star us on [GitHub](https://github.com/netbirdio/netbird)
|
||||||
- Follow us [on Twitter](https://twitter.com/netbird)
|
- Follow us [on Twitter](https://twitter.com/netbird)
|
||||||
- Join our [Slack Channel](https://join.slack.com/t/netbirdio/shared_invite/zt-2p5zwhm4g-8fHollzrQa5y4PZF5AEpvQ)
|
- Join our [Slack Channel](https://join.slack.com/t/netbirdio/shared_invite/zt-2p5zwhm4g-8fHollzrQa5y4PZF5AEpvQ)
|
||||||
- NetBird release page on GitHub: [releases](https://github.com/netbirdio/netbird/releases/latest)
|
- NetBird release page on GitHub: [releases](https://github.com/netbirdio/netbird/releases/latest)
|
||||||
|
|||||||