HSVE Agent

What the Agent does

The HSVE Agent runs inside your Proxmox environment and maintains authenticated outbound channels to Portal. It reports inventory and performs only the Portal actions authorised for the Site and user.

• Inventory and heartbeat reporting.
• VM power and supported configuration actions.
• Snapshots and backup operations.
• Virtual KVM and optional private RDP relay paths.
• Marketplace deployment work on the target Proxmox node.

Installed services

systemctl status hsve-agent --no-pager
systemctl status hsve-agent-console --no-pager
systemctl status hsve-agent-management --no-pager
systemctl status hsve-agent-deployment --no-pager

The Agent's cloud credential and local Proxmox API token are stored on the Proxmox host in /etc/hsve-agent.env with restricted permissions.

Update an existing Agent

Running the current installer again on an already enrolled host upgrades the Agent in place while preserving its existing Site identity.

curl -fsSL https://portal.hsve.co.uk/agent/install.sh | sudo bash

If Portal reports Agent update required for a feature such as Marketplace deployment, update the target Proxmox node before retrying the action.

Rotate the Agent cloud credential

1. Open Agents in Portal.
2. Authorise credential rotation for the target Agent.
3. Run the rotation command on that Proxmox host within the allowed window.

curl -fsSL https://portal.hsve.co.uk/agent/install.sh | sudo bash -s -- --rotate

Revoke or re-enrol an Agent

Use Revoke in Portal if a Proxmox host is retired, compromised or should no longer communicate with the Site. A revoked Agent cannot use its old cloud credential. Re-enrolment requires a fresh one-time enrolment request.