@cryptotaxi247 / netdata-1 / commits / 0694157fe

docs: add warning about mode=none disabling streaming capability (#22056)

* docs: add warning about mode=none disabling streaming Add a warning admonition to the 'Disable the Local Dashboard' section explaining that mode=none disables the entire web server on port 19999, including streaming capability. This clarifies that parent-child streaming architectures should NOT use this setting. * docs: clarify mode=none impact on streaming per Copilot review - Distinguish between inbound streaming (blocked) and outbound streaming (not inherently disabled) - Clarify bearer token protection secures dashboard/API access, not streaming connections - Reference default port 19999 for accuracy with non-default configurations - Address all 3 Copilot review suggestions from PR #22056 * Update docs/netdata-agent/securing-netdata-agents.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update docs/netdata-agent/securing-netdata-agents.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * docs: add warning about mode=none impact on streaming to web server reference * docs: simplify mode=none admonition to concise note * docs: simplify mode=none admonition to concise single-paragraph note * docs: compact mode=none admonition to reduce line span * docs: add blank lines to mode=none admonition for consistent rendering * docs: compact mode=none admonition to minimize line span * docs: fix mode=none admonition terminology and formatting Uppercase Netdata terminology (Agent, Child Agents, Parent Agents) and use 5-line admonition structure with blank lines per docs-writing-instructions. * Apply suggestions from code review Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud> * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> * update * update --------- Co-authored-by: nedi-app[bot] <bot@netdata.cloud> Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud>

nedi-app[bot] committed Apr 6, 2026 at 08:53 UTC 0694157fe5d0d35b828f4ccc8e5638f7270a359a
2 files changed +18 -1
docs/netdata-agent/securing-netdata-agents.md
+8 -1
@@ -45,7 +45,14 @@ Edit the `[web]` section in `netdata.conf` using the [`edit-config`](/docs/netda
45 mode = none
46 ```
47
48 -Restart your Agent to apply changes. After restart, the local dashboard (http://NODE:19999) will no longer be accessible, but all metrics remain available through Netdata Cloud.
48 +Restart your Agent to apply changes. After restart, the Agent's web server (default port `19999`) will no longer accept inbound connections.
49 +
50 +:::warning
51 +
52 +This disables inbound connections, including streams from Child Agents.
53 +**Do not use this setting on Parent Agents.**
54 +
55 +:::
56
57 :::tip
58
src/web/server/README.md
+10
@@ -146,6 +146,16 @@ Edit the `[web]` section in `netdata.conf` (see [Configure Basic Settings](#conf
146 mode = none
147 ```
148
149 +Restart your Agent to apply changes. After restart, the Agent's web server (default port `19999`) will no longer accept inbound connections.
150 +
151 +
152 +:::warning
153 +
154 +This disables inbound connections, including streams from Child Agents.
155 +**Do not use this setting on Parent Agents.**
156 +
157 +:::
158 +
159 </details>
160
161 <details>