diff --git a/src/pages/how-to/getting-started.mdx b/src/pages/how-to/getting-started.mdx index 10ff6521..ccb1732b 100644 --- a/src/pages/how-to/getting-started.mdx +++ b/src/pages/how-to/getting-started.mdx @@ -4,8 +4,6 @@ export const title = 'Getting Started' ## Quickstart Guide -Step-by-step video guide on YouTube: -
@@ -15,15 +13,17 @@ This guide describes how to quickly get started with NetBird and create a secure 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. -1. Sign-up at [https://app.netbird.io/](https://app.netbird.io/) - +## Create a NetBird Account +Sign-up at [app.netbird.io](https://app.netbird.io/) You can use your Google, GitHub or Microsoft account.

login-to-netbird

-2. After a successful login you will be redirected to the ```Peers``` screen which is empty because you don't have any peers yet. +## 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. The `Add peer` window should automatically pop up, but if it doesn't, click ```Add new peer``` to add a new machine. @@ -31,43 +31,51 @@ The `Add peer` window should automatically pop up, but if it doesn't, click ```A login-to-netbird

-3. Choose your machine operating system (in our case it is ```Linux```) and proceed with the installation steps. +Choose your machine operating system (in our case it is ```Linux```) and proceed with the installation steps.

login-to-netbird

-4. If you installed NetBird Desktop UI you can use it to connect to the network instead of running `netbird up` command. +## 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`. >

login-to-netbird

-5. At this point a browser window pops up starting a device registration process. Click confirm and follow the steps if required. + +At this point a browser window pops up starting a device registration process. Click confirm and follow the steps if required.

login-to-netbird

-6. On the EC2 node repeat the installation steps and run `netbird up` command. +## Connect Your EC2 Node + +On the EC2 node repeat the installation steps and run `netbird up` command. ```bash sudo netbird up ``` -7. Copy the verification URL from the terminal output and paste it in your browser. Repeat step #5 + +Copy the verification URL from the terminal output and paste it in your browser. Repeat step #5

login-to-netbird

-8. Return to ```Peers``` and you should notice 2 new machines with status ```online``` +## Validate Connection + +Return to ```Peers``` and you should notice 2 new machines with status ```online```

login-to-netbird

-9. To test the connection you could try pinging devices: +To test the connection you could try pinging devices: On your laptop: ```bash @@ -78,7 +86,7 @@ On the EC2 node: ```bash ping my-linux-laptop.netbird.cloud ``` -10. Done! You now have a secure peer-to-peer private network configured. +Done! You now have a secure peer-to-peer private network configured.