docs: Add unclaim/reclaim node guide

[kanelatechnical]

Create new documentation for moving nodes between Spaces without complete removal.

Files changed:

• docs/learn/unclaim-reclaim-node.md (new)
• docs/.map/map.csv (map entry added)

---

Summary by cubic

Added a guide for unclaiming and reclaiming nodes to move agents between Spaces without removing them. Updated the docs map to publish it under Netdata Cloud.

• New Features
  • Step-by-step unclaim for Linux and Docker, with restart note.
  • Reclaim options: kickstart, config file, env vars.
  • Verification and troubleshooting tips (corrected log path and connection check).
  • Links to removal guide, reconnect agent, and token generation.

^{Written for commit 67c7efa. Summary will update on new commits.}

[cubic-dev-ai]

No issues found across 2 files

[ilyam8]

@kanelatechnical wrong map.csv changes

[kanelatechnical]

@ilyam8 ughh there were conflicts, and I was uncertain what to choose, so I chose to accept both. Do you advise deleting and editing again?

[ilyam8]

Your PR adds 324 lines to map.csv. You need to undo all changes to that file and add only line - the new file.

[kanelatechnical]

did it but I am afraid to resolve @ilyam8

[Copilot]

Pull request overview

This PR adds comprehensive documentation for moving Netdata nodes between Spaces using the unclaim and reclaim process, providing an alternative to permanent node removal.

Changes:

• Added new guide explaining the difference between unclaiming/reclaiming vs removing nodes
• Documented unclaim procedures for both Linux and Docker installations
• Provided three reclaim options: kickstart script, configuration file, and environment variables

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ilyam8]

@kanelatechnical Have you tried following this guide to unclaim/claim a node? Was it successful?

[kanelatechnical]

restart after sudo rm -rf /var/lib/netdata/cloud.d/

[kanelatechnical]

var/log substituted by deamon/log

[Ancairon]

Guys, I think this has some duplicate info, with https://learn.netdata.cloud/docs/netdata-cloud/connect-agent#reconnect-agent. Ideally we would make that section point to a link if we add this as a page.

[cubic-dev-ai]

1 issue found across 1 file (changes from recent commits).

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="docs/learn/unclaim-reclaim-node.md">

<violation number="1" location="docs/learn/unclaim-reclaim-node.md:110">
P3: Indent “or:” to keep it in the nested list under “Review agent logs using:”. As written, it becomes a top‑level bullet and breaks the list structure.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}