From f4886c2dfbb519cc291bc318568190915848726e Mon Sep 17 00:00:00 2001
From: rcourtman <8825017+rcourtman@users.noreply.github.com>
Date: Tue, 1 Sep 2026 06:36:02 +0100
Subject: [PATCH] Document per-node agent installs for PVE clusters

The generated install command is host-generic, but nothing said so, and
cluster operators kept asking how to cover every member (#1816, #1618).
State it in the agent Quick Start next to the command generator pointer.

Refs #1816
---
 docs/UNIFIED_AGENT.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/UNIFIED_AGENT.md b/docs/UNIFIED_AGENT.md
index 079acafba..a7c3b7f13 100644
--- a/docs/UNIFIED_AGENT.md
+++ b/docs/UNIFIED_AGENT.md
@@ -26,6 +26,12 @@ Generate an installation command in the UI:
 
 Choose a target profile in that screen when you want explicit install flags for Docker, Kubernetes, Proxmox VE, or Proxmox Backup Server.
 
+The generated command is not tied to a single machine. For a Proxmox VE
+cluster, one API connection already provides cluster-wide inventory; the agent
+is per host, so run the same generated command on each cluster node where you
+want agent-provided telemetry (temperatures, SMART, host identity). Each agent
+registers itself and attaches to its own cluster member.
+
 The same generated command is also the supported v5-to-v6 agent upgrade path.
 Run it on the host that already has the v5 `pulse-agent` service to replace the
 binary and service configuration in place; do not uninstall the old service