Connect Proxmox VE#

Add your Proxmox cluster to LabTether and see VMs, containers, and node metrics in one place.

Prerequisites#

• A Proxmox VE 7+ cluster or standalone node
• An API token with at least PVEAuditor role (read-only access is sufficient)

Create a Proxmox API token#

1. In Proxmox, go to Datacenter → Permissions → API Tokens
2. Click Add
3. Select your admin user, give the token an ID (e.g., labtether), and uncheck "Privilege Separation"
4. Copy the token value — you'll need it in the next step

Add the connector#

1. In LabTether, click + Add Device
2. Select Proxmox VE
3. Enter your Proxmox API URL: https://your-proxmox:8006
4. Enter the token in the format: user@realm!tokenid=token-value
5. Click Test Connection
6. If successful, click Save

What you'll see#

After the first sync (usually within 30 seconds):

• Devices page shows your Proxmox node(s), VMs, and LXC containers
• Topology maps the hierarchy (node → VMs/containers)
• Dashboard metrics include Proxmox node CPU, memory, and storage from RRD data
• Remote View offers SPICE console access to VMs (if SPICE is enabled on the VM)

Troubleshooting#

• Connection refused: Ensure the Proxmox API is reachable from the LabTether host. Check firewall rules for port 8006.
• Authentication failed: Verify the token format includes the realm (user@pam!tokenid=value).
• 0 resources visible: The API token may lack permissions. Assign at least PVEAuditor at the datacenter level.