@cryptotaxi247 / netdata-1 / commits / f1dcd09ed

docs: add section on changing the default port (#22084)

* docs: add section on changing the default port Add documentation explaining how to change Netdata's default listening port from 19999 to a custom value using the 'default port' configuration option in the [web] section of netdata.conf. * docs: add 'Change the Default Port' example to web server README Add a new collapsible example section showing how to change the Netdata default port from 19999 to a custom port using edit-config and systemctl. * docs: remove port configuration section from configuration README The port configuration documentation has been moved to the more appropriate web server README (src/web/server/README.md) where web server settings are documented. This removes the duplicate section from the general configuration guide. * docs: remove duplicate edit-config links in examples * docs: replace plain restart command with link to service control documentation Replace inline restart command example in 'Change the Default Port' section with a link to the canonical service control documentation at /docs/netdata-agent/start-stop-restart.md as requested by reviewer. * Update src/web/server/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> --------- 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>

nedi-app[bot] committed Mar 31, 2026 at 13:10 UTC f1dcd09edfecba5b6fe662a5083047987c31c68b

1 file changed +16 -1

src/web/server/README.md

+16 -1

@@ -139,7 +139,7 @@ If you publish your Netdata web server to the internet, you may want to apply so

139 <details>

140 <summary>Disable the Web Server</summary>

141

142 -Edit `netdata.conf` using the [`edit-config` script](/docs/netdata-agent/configuration/README.md#edit-configuration-files)

142 +Edit the `[web]` section in `netdata.conf` (see [Configure Basic Settings](#configure-basic-settings) for edit-config usage):

143

144 ```text

145 [web]

@@ -161,6 +161,21 @@ Control the number of threads and sockets with the following settings:

161

162 </details>

163

164 +<details>

165 +<summary>Change the Default Port</summary>

166 +

167 +By default, the Netdata web server listens on port `19999`. To change the default port, edit the `[web]` section in `netdata.conf` (see [Configure Basic Settings](#configure-basic-settings) for edit-config usage):

168 +

169 +```text

170 +[web]

171 + default port = 8000

172 +```

173 +

174 +If you have configured `[web].bind to` with explicit ports, you must also update those explicit port numbers, or remove the port portion so the entries fall back to using `default port`.

175 +After modifying the configuration, restart the Netdata service to apply changes. See the [service control documentation](/docs/netdata-agent/start-stop-restart.md) for instructions.

176 +

177 +</details>

178 +

179 <details>

180 <summary>Binding Netdata to Multiple Ports</summary>

181