diff --git a/docs/how-to-guides/nameservers.md b/docs/how-to-guides/nameservers.md index 9b7ec9c9..c25c82c1 100644 --- a/docs/how-to-guides/nameservers.md +++ b/docs/how-to-guides/nameservers.md @@ -106,7 +106,7 @@ Currently, only MacOS, Windows 10+, and Linux running systemd-resolved support n ::: ### Distributing the settings with groups -You can select as many distribution groups as you want for your nameserver setup, keep in mind to link them to peers and if required, to access control rules when using private nameservers. +You can select as many distribution groups as you want for your nameserver setup. Keep in mind to link them to peers and, if required, to add access control rules when using private nameservers. ### Adding remote private DNS servers To add a private DNS server that is running behind routing peers, you need to create resources to ensure communication between your nameserver clients can communicate. In the Berlin office example from previous steps, we have a peer from the `Office network` that can route traffic to the `192.168.0.32` IP, so we need to ensure that a similar network route exists:

diff --git a/docs/how-to-guides/network-routes.md b/docs/how-to-guides/network-routes.md index d6792b5a..840fc605 100644 --- a/docs/how-to-guides/network-routes.md +++ b/docs/how-to-guides/network-routes.md @@ -49,6 +49,12 @@ If you don't enable this option, you must configure a route to your NetBird netw ### Metric and priority Metric defines prioritization when choosing the main routing peer in a high availability network. Lower metrics have higher priority. +### Distribution groups +Distribution groups define that peers that belong to groups set in this field will receive the network route. +:::info +It doesn't remove the need for the routing peer to be connected to these peers +::: + ## Managing network routes A network route describes a network you want to connect with your NetBird peers. It has an identifier, a network range, a routing peer, and some parameters available for managing priority and masquerading. @@ -66,12 +72,13 @@ In the example below, we are creating a route with the following information: - Description: `Production VPC in Frankfurt` - Network range: `172.31.0.0/16` - Routing peer: `aws-nb-europe-router-az-a` +- Distribution Groups: `All`

high-level-dia

-Once you fill in the route information, you can click on the `Create` button to save your new route. +Once you fill in the route information, you can click on the `Save` button to save your new route.

high-level-dia

@@ -83,14 +90,9 @@ However, you still want to ensure a reliable connection to your private network NetBird Network Routes feature has a High Availability (HA) mode, allowing one or more NetBird peers to serve as routing peers for the same private network. -Creating highly available routes requires the same steps as creating a single route. The only difference is that you must copy the same network identifier and network range from another route. +To enable high-available mode, you can click on `Configure` and select a new peer in the `Add additional routing peer` field, then select the distribution groups and click on `Save`. -So if we would like to enable High Availability for the route created in the previous step, we would copy most of the information and assign the new route to a different peer: - -- Network identifier: `aws-eu-central-1-vpc` -- Description: `Production VPC in Frankfurt` -- Network range: `172.31.0.0/16` -- Routing peer: `aws-nb-europe-router-az-b` +In the following screenshot, we are adding the peer `aws-nb-europe-router-az-b` to the `aws-eu-central-1-vpc` route:

high-level-dia @@ -106,6 +108,8 @@ This way, nodes connected to both peer `aws-nb-europe-router-az-a` and peer `aws Currently, there is no limitation in the number of routes that form a highly available route. Each connected peer will pick one routing peer to use as the router for a network; this decision is based on metric prioritization and connection attributes like direct or relayed connections. ::: +### Filtering routes distribution with groups +You can select as many distribution groups as you want for your network route. You can update them at the routing peer or high-availability group level. Keep in mind to link them to peers and, if required, to add access control rules ensuring connectivity between these peers and the routing peers of your route ### Routes without masquerading If you want more transparency and would like to manage your external network routers, you may choose to disable masquerade for your network routes. In this case, the routing peer won't hide any NetBird peer IP and will forward the packets to the target network transparently. diff --git a/static/img/how-to-guides/netbird-network-routes-add-button.png b/static/img/how-to-guides/netbird-network-routes-add-button.png index af983ff0..4604f5c7 100644 Binary files a/static/img/how-to-guides/netbird-network-routes-add-button.png and b/static/img/how-to-guides/netbird-network-routes-add-button.png differ diff --git a/static/img/how-to-guides/netbird-network-routes-create-ha.png b/static/img/how-to-guides/netbird-network-routes-create-ha.png index 77b5015b..0a25c099 100644 Binary files a/static/img/how-to-guides/netbird-network-routes-create-ha.png and b/static/img/how-to-guides/netbird-network-routes-create-ha.png differ diff --git a/static/img/how-to-guides/netbird-network-routes-create.png b/static/img/how-to-guides/netbird-network-routes-create.png index cc3bf893..8c7a1483 100644 Binary files a/static/img/how-to-guides/netbird-network-routes-create.png and b/static/img/how-to-guides/netbird-network-routes-create.png differ diff --git a/static/img/how-to-guides/netbird-network-routes-saved-new-ha.png b/static/img/how-to-guides/netbird-network-routes-saved-new-ha.png index 4c72f323..94956a6e 100644 Binary files a/static/img/how-to-guides/netbird-network-routes-saved-new-ha.png and b/static/img/how-to-guides/netbird-network-routes-saved-new-ha.png differ diff --git a/static/img/how-to-guides/netbird-network-routes-saved-new.png b/static/img/how-to-guides/netbird-network-routes-saved-new.png index 884cb835..4cc6b66e 100644 Binary files a/static/img/how-to-guides/netbird-network-routes-saved-new.png and b/static/img/how-to-guides/netbird-network-routes-saved-new.png differ