Skip to content

Commit d2c7710

Browse files
Add Reverse Proxy Templates + Wizard Instructions to Docs (#551)
* Add Reverse Proxy Templates + Wizard Instructions to Docs - Updated quickstart guide to include instructions on new reverse proxy wizard in setup script - Add new reverse proxy page including quickstart script instructions and templates - Updated advanced guide to refer to new reverse proxy page * Update lazy-connection documentation to clarify inactivity threshold configuration. from #452 * Added <Note> * Update lazy connection documentation to reflect new minimum supported agent version and server requirements. From PR#338 * traefik ssl amendments + nginx fixes * - add youtube video to self hosted quickstart guide page - clarify quickstart script reverse proxy wizard behaviour in advanced guide * added in-depth TLS instructions for nginx * add individual proxy hyperlinks to self hosted advanced guide --------- Co-authored-by: Brandon Hopkins <brandon@techhut.tv>
1 parent eb2cae2 commit d2c7710

5 files changed

Lines changed: 1009 additions & 67 deletions

File tree

src/components/NavigationDocs.jsx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -314,7 +314,8 @@ export const docsNavigation = [
314314
},
315315
]
316316
},
317-
{ title: 'Advanced guide', href: '/selfhosted/selfhosted-guide' },
317+
{ title: 'Reverse Proxy', href: '/selfhosted/reverse-proxy' },
318+
{ title: 'Advanced Guide', href: '/selfhosted/selfhosted-guide' },
318319
{ title: 'Management SQLite Store', href: '/selfhosted/sqlite-store' },
319320
{ title: 'Management Postgres Store', href: '/selfhosted/postgres-store' },
320321
{ title: 'Activity Events Postgres Store', href: '/selfhosted/activity-postgres-store' },

src/pages/manage/peers/lazy-connection.mdx

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ NetBird now includes an experimental lazy connection feature designed to improve
66
This guide walks you through enabling and configuring this feature in your NetBird client.
77

88
<Note>
9-
Minimum supported agent version: <strong>v0.45.0</strong>.
9+
Minimum supported agent version: <strong>v0.50.1</strong>.
1010
This or higher version must also be installed on the peers you are trying to access for lazy connections to function.
1111
</Note>
1212

1313
<Note>
14-
This feature also requires an upgraded NetBird Management server.
15-
If you're self-hosting NetBird, ensure your server is updated to version <strong>v0.45.0</strong>, which adds support for lazy connections.
14+
This feature also requires an upgraded NetBird Management and Signal server.
15+
If you're self-hosting NetBird, ensure your server is updated to version <strong>v0.50.1</strong>, which adds support for lazy connections.
1616
</Note>
1717

1818
<Note>
@@ -25,7 +25,7 @@ When enabled, lazy connections allow the NetBird agent to:
2525

2626
- Establish peer-to-peer connections **only when needed** (e.g., when pinging a remote peer).
2727
- Monitor peer activity and **automatically disconnect peers** that remain inactive **and unreachable** for a specified time.
28-
- Keep critical peers (such as routers or excluded peers) **always connected** to ensure uninterrupted communication.
28+
- Keep critical peers (such as excluded peers) **always connected** to ensure uninterrupted communication.
2929

3030
This feature is especially useful in **large-scale deployments** or **resource-constrained environments**, where maintaining full-mesh, permanent connections to all peers is unnecessary and inefficient.
3131

@@ -36,16 +36,12 @@ This feature is especially useful in **large-scale deployments** or **resource-c
3636

3737
### How Automatic Disconnection Works
3838

39-
Once a connection between two peers is established, it will remain open **as long as the remote peer is reachable**. The connection is **not** closed just because there is no data transfer.
40-
41-
In other words, the inactivity timer only triggers a disconnect if the peer is both <em>inactive</em> and <em>unreachable</em> for the full duration of the threshold.
39+
Once a connection between two peers is established, it will remain open only if there is ongoing traffic from the remote peer. If no traffic is received for 15 minutes, the connection will be closed — even if the remote peer is still reachable.
4240

4341
<Note>
44-
The default inactivity threshold is <strong>60 minutes</strong>, and can be configured via the <code>NB_LAZY_CONN_INACTIVITY_THRESHOLD</code> environment variable.
42+
The default inactivity threshold is <strong>60 minutes</strong>, and can be configured via the <code>NB_LAZY_CONN_INACTIVITY_THRESHOLD</code> environment variable (`60`).
4543
</Note>
4644

47-
Additionally, the disconnection logic is being improved and will be enhanced in future releases to better support mobile devices—providing more intelligent reconnection behavior and improved handling of intermittent connectivity.
48-
4945
## Enabling Lazy Connections on agent
5046

5147
Lazy connections are disabled by default. You can enable Lazy Connections using the following environment variable:

0 commit comments

Comments
 (0)