Connect a Proxmox Site

Create a Site

A Site is the Portal boundary around one Proxmox environment. It can represent a standalone Proxmox VE host or a cluster.

1. Open Proxmox Sites in Portal.
2. Enter a recognisable Site name between 2 and 80 characters.
3. Select Create enrolment.
4. Copy the generated install command.

Run the enrolment command

Portal generates a unique command similar to the example below. Run the actual command shown in your Portal; do not reuse an old token.

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

• The enrolment token is valid for 15 minutes.
• It is intended for one successful enrolment and then becomes unusable.
• Run the installer directly on a Proxmox VE host; it deliberately refuses to install on a normal Debian/Ubuntu server.
• Generate a fresh enrolment if the original token expires.

What the installer configures

• A dedicated local hsve-agent service account.
• A dedicated Proxmox user and privilege-separated API token for supported Portal operations.
• Verified HTTPS access to the local Proxmox API.
• Inventory, management, console and deployment services used by Portal.
• Outbound authenticated communication with HSVE Cloud.

Network requirements

• Outbound HTTPS/WSS from the Proxmox environment to HSVE services.
• Local access from the Agent to the Proxmox API on the host/cluster network.
• No requirement to expose TCP 8006 publicly.
• Optional Windows Remote Desktop also does not require public TCP 3389; the Agent reaches the VM from inside the Site.

Confirm the Site is online

1. Return to Proxmox Sites.
2. Refresh if required.
3. Confirm the Site shows Online.
4. Confirm Last heartbeat is current.
5. Open Overview or Virtual Machines and verify inventory begins to populate.