You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This or higher version must also be installed on the peers you are trying to access for lazy connections to function.
11
11
</Note>
12
12
13
13
<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.
16
16
</Note>
17
17
18
18
<Note>
@@ -25,7 +25,7 @@ When enabled, lazy connections allow the NetBird agent to:
25
25
26
26
- Establish peer-to-peer connections **only when needed** (e.g., when pinging a remote peer).
27
27
- 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.
29
29
30
30
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.
31
31
@@ -36,16 +36,12 @@ This feature is especially useful in **large-scale deployments** or **resource-c
36
36
37
37
### How Automatic Disconnection Works
38
38
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.
42
40
43
41
<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`).
45
43
</Note>
46
44
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
-
49
45
## Enabling Lazy Connections on agent
50
46
51
47
Lazy connections are disabled by default. You can enable Lazy Connections using the following environment variable:
0 commit comments