From ce237789614aeeab27d860360b3e5fe99a0ede81 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 13:11:25 +0200
Subject: [PATCH 01/14] Create access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 56 ++++++++++++++++++++++++
1 file changed, 56 insertions(+)
create mode 100644 src/pages/how-to/access-home-network.mdx
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
new file mode 100644
index 00000000..48fb655a
--- /dev/null
+++ b/src/pages/how-to/access-home-network.mdx
@@ -0,0 +1,56 @@
+# How to Setup NetBird to Access Home Network
+
+This step by step guide describes how to quickly get started with NetBird and create secure access to your home network remotely.
+
+## Getting Started
+
+1. Download and Install NetBird
+
+
+
+
+1. 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`:
+
+
+
+
+
+
+ Alternatively, you can run the `netbird up` command in the terminal.
+
+
+ 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:
+
+
+
+
+
+ After the registration is complete, proceed to the [**NetBird dashboard**](https://app.netbird.io/) to confirm that your laptop is in the network. You will see it in the `Peers` view.
+
+2. Create a new Network in the NetBird dashboard
+ 1. Go to the **Networks** tab in the side bar
+ 2. Click **Add Network** and give it a name such as “Home LAN”, and optionally add a description.
+
+3. Define Your LAN as a network resource
+ 1. Click **Add Resource.**
+ 2. Enter a name like “Home Network” and the CIDR of your home network into the Address field (e.g `192.168.1.0/24`).
+ 3. Assign it to a Destination Group, create one called “home-lan” so you can write access policies using this group.
+ 4. Click **Add Resource**.
+
+4. Create an Access Control Policy to allow peers to reach your LAN
+ 1. After adding your resource, click Create Policy.
+ 2. Set Source to the group of NetBird peers you trust (for example “All Users” or a dedicated “Home Devices” group).
+ 3. Set **Destination** to the “home-lan” group you made.
+ 4. For **Protocol**, choose All (or restrict to TCP/UCP if you prefer).
+ 5. Name it “Home LAN Access” and click **Add Policy**.
+
+5. Choose or provision a routing peer in your LAN
+ 1. Click **Add Routing Peer**.
+ 2. Pick any always-on machine on your home network (Windows, Linux, Mac, Docker, Raspberry Pi).
+ 3. Install the NetBird agent on it using a single-use setup key using the CLI installer.
+ 4. Ensure this machine has access to both the internet and your LAN subnet.
+ 5. Choose this machine as your routing peer and click **Continue** and **Add Routing Peer**.
+
+That’s it! You’ve mapped your entire home LAN into a NetBird Network. Any peer you’ve granted in your access policy will now securely route traffic to all devices on your home subnet via your routing peer, without opening any router ports or installing software on every device.
From fdb512df70770f863bfd4a79755c55b5c0520a03 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 13:19:20 +0200
Subject: [PATCH 02/14] add png for new dark mode device login
for access home network doc page
---
.../img/how-to-guides/login-screen-dark.png | Bin 0 -> 34785 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 public/docs-static/img/how-to-guides/login-screen-dark.png
diff --git a/public/docs-static/img/how-to-guides/login-screen-dark.png b/public/docs-static/img/how-to-guides/login-screen-dark.png
new file mode 100644
index 0000000000000000000000000000000000000000..816882f8b48f1020503372b195399d5e0799f01f
GIT binary patch
literal 34785
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�Tvml~_wHmT=ojA`_m
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 x>#w@RYsOYPu7>yMwMz~-jcvYg-I
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
I)c^6{0DPhPlmGw#
literal 0
HcmV?d00001
From e60d10a5a8758e0a6ec08e2c9b4e5de80257d76c Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 13:22:18 +0200
Subject: [PATCH 03/14] Update access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
index 48fb655a..ef2e8539 100644
--- a/src/pages/how-to/access-home-network.mdx
+++ b/src/pages/how-to/access-home-network.mdx
@@ -24,7 +24,7 @@ This step by step guide describes how to quickly get started with NetBird and cr
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:
-
+
After the registration is complete, proceed to the [**NetBird dashboard**](https://app.netbird.io/) to confirm that your laptop is in the network. You will see it in the `Peers` view.
From ae42e64c7e44142d69a23bb2bdd616241822d788 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 13:34:06 +0200
Subject: [PATCH 04/14] Update access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
index ef2e8539..53cd2ec4 100644
--- a/src/pages/how-to/access-home-network.mdx
+++ b/src/pages/how-to/access-home-network.mdx
@@ -34,13 +34,13 @@ This step by step guide describes how to quickly get started with NetBird and cr
2. Click **Add Network** and give it a name such as “Home LAN”, and optionally add a description.
3. Define Your LAN as a network resource
- 1. Click **Add Resource.**
+ 1. Click **Add Resource**.
2. Enter a name like “Home Network” and the CIDR of your home network into the Address field (e.g `192.168.1.0/24`).
3. Assign it to a Destination Group, create one called “home-lan” so you can write access policies using this group.
4. Click **Add Resource**.
4. Create an Access Control Policy to allow peers to reach your LAN
- 1. After adding your resource, click Create Policy.
+ 1. After adding your resource, click **Create Policy**.
2. Set Source to the group of NetBird peers you trust (for example “All Users” or a dedicated “Home Devices” group).
3. Set **Destination** to the “home-lan” group you made.
4. For **Protocol**, choose All (or restrict to TCP/UCP if you prefer).
From 3529fff20004d4cec0145ab3dcd1aacc92cc34b6 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 13:56:38 +0200
Subject: [PATCH 05/14] Update access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
index 53cd2ec4..3be5958f 100644
--- a/src/pages/how-to/access-home-network.mdx
+++ b/src/pages/how-to/access-home-network.mdx
@@ -1,3 +1,7 @@
+import {Note} from "@/components/mdx";
+
+export const title = 'Getting Started'
+
# How to Setup NetBird to Access Home Network
This step by step guide describes how to quickly get started with NetBird and create secure access to your home network remotely.
From dcf9bc08e93c81085d5104b3d1b1327149318a1d Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 4 Jul 2025 14:03:51 +0200
Subject: [PATCH 06/14] Update access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
index 3be5958f..a96d1964 100644
--- a/src/pages/how-to/access-home-network.mdx
+++ b/src/pages/how-to/access-home-network.mdx
@@ -2,7 +2,7 @@ import {Note} from "@/components/mdx";
export const title = 'Getting Started'
-# How to Setup NetBird to Access Home Network
+# How to Setup NetBird to Access Your Home Network
This step by step guide describes how to quickly get started with NetBird and create secure access to your home network remotely.
From 39baf39f7ae0a0da2be69e885e31a0c33af15760 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Tue, 8 Jul 2025 18:03:22 +0200
Subject: [PATCH 07/14] Update access-home-network.mdx
---
src/pages/how-to/access-home-network.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/pages/how-to/access-home-network.mdx b/src/pages/how-to/access-home-network.mdx
index a96d1964..0bc3f318 100644
--- a/src/pages/how-to/access-home-network.mdx
+++ b/src/pages/how-to/access-home-network.mdx
@@ -47,7 +47,7 @@ This step by step guide describes how to quickly get started with NetBird and cr
1. After adding your resource, click **Create Policy**.
2. Set Source to the group of NetBird peers you trust (for example “All Users” or a dedicated “Home Devices” group).
3. Set **Destination** to the “home-lan” group you made.
- 4. For **Protocol**, choose All (or restrict to TCP/UCP if you prefer).
+ 4. For **Protocol**, choose All.
5. Name it “Home LAN Access” and click **Add Policy**.
5. Choose or provision a routing peer in your LAN
From dc1d7b74d660a2a712641bbd9977cf56d2b19b66 Mon Sep 17 00:00:00 2001
From: Jack Carter <128555021+SunsetDrifter@users.noreply.github.com>
Date: Fri, 18 Jul 2025 18:05:06 +0200
Subject: [PATCH 08/14] Add screenshots for accessing home network guide
---
.../img/how-to-guides/add-network-home-lan.png | Bin 0 -> 44433 bytes
.../img/how-to-guides/add-policy-home-lan.png | Bin 0 -> 79143 bytes
.../how-to-guides/add-resource-home-network.png | Bin 0 -> 75852 bytes
.../add-routing-peer-home-network.png | Bin 0 -> 85711 bytes
.../img/how-to-guides/add-routing-peer.png | Bin 0 -> 56159 bytes
5 files changed, 0 insertions(+), 0 deletions(-)
create mode 100644 public/docs-static/img/how-to-guides/add-network-home-lan.png
create mode 100644 public/docs-static/img/how-to-guides/add-policy-home-lan.png
create mode 100644 public/docs-static/img/how-to-guides/add-resource-home-network.png
create mode 100644 public/docs-static/img/how-to-guides/add-routing-peer-home-network.png
create mode 100644 public/docs-static/img/how-to-guides/add-routing-peer.png
diff --git a/public/docs-static/img/how-to-guides/add-network-home-lan.png b/public/docs-static/img/how-to-guides/add-network-home-lan.png
new file mode 100644
index 0000000000000000000000000000000000000000..87f454c447d56c0608550d102ba00011bca83845
GIT binary patch
literal 44433
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
+ 
+ 