docs: task class: improve_docs — add the 'is our localhost - not changing (#22526)
* docs: update docs/netdata-remove-stale-node-localhost-error * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: nedi-app[bot] <nedi-app[bot]@users.noreply.github.com> Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
nedi-app[bot] committed
May 22, 2026 at 05:40 UTC
60aacb887247e0f7a098bbccf7c9066646a675da
1 file changed
+2
docs/learn/remove-node.md
+2
@@ -165,6 +165,8 @@ To prevent removed nodes from reappearing:
165
166
**"Permission denied"**: You need **Admin** role in the Space to remove nodes.
167
168
+**"Node '<name>' (machine guid: <guid>) is our localhost - not changing it"**: The machine GUID you provided belongs to the agent where you are running `netdatacli`—in this procedure, that should be the Parent Agent—not the stale child node you want to remove. This usually happens when you accidentally copy the Parent's own machine GUID instead of the stale child's. Verify you are using the correct machine GUID by checking the stale child's node info in Netdata Cloud — the GUID must belong to the disconnected child, not the Parent Agent you are logged into.
169
+
170
**Node reappears after removal**: The agent may still be running and configured to reconnect. Stop the agent and clear claim configuration.
171
172
## Additional Resources