My Proxmox Cluster
Proxmox Manager
Background Jobs
No active jobs
Configured Clusters 1 cluster(s)
My Proxmox Cluster Active
ID: main
1 node(s)
Checking Online Offline Error
10.0.0.100
Add New Cluster
Cluster Information
A friendly name for your Proxmox cluster
Unique identifier (letters, numbers, underscores, and dashes only)
When enabled, updates the cluster's next-id lower bound after each VM/container creation to prevent VMID reuse. This avoids mixing backups and monitoring data from deleted VMs.
Node Connection
IP address or hostname of your Proxmox node
Usually root@pam (for API token, use user@realm format without token suffix)
Root password for Proxmox
Token ID (without user prefix)
Token secret value (UUID format)
API Token Format
Create tokens in Proxmox under Datacenter → Permissions → API Tokens. The token is in format user@realm!tokenid - enter just the token ID here.
Uncheck if using self-signed certificates (common for home labs)
Note
Some features (writing custom cloud-init snippets to node storage) need filesystem access to a node. When ProxUI runs remotely it reaches nodes over SSH (port 22) or the node Shell/termproxy (over the API port). You'll be guided to install ProxUI's SSH key — a one-time step using root's password — from the Cloud-Init tab when needed. Basic cloud-init (user, password, SSH keys, IP/DNS) works over the API alone.
Connection successful!
Connected to running Proxmox VE
Connection failed
Need Help?
Common Issues
  • Connection refused: Check if Proxmox web interface is accessible
  • SSL errors: Uncheck "Verify SSL Certificate" for self-signed certs
  • Authentication failed: Verify username/password or token credentials
  • Network timeout: Ensure firewall allows port 8006
  • No data with API token: Ensure "Privilege Separation" is unchecked when creating the token, or assign PVEAuditor role to the token
Default Settings
  • Web Interface: https://your-ip:8006
  • Username: root@pam
  • Port: 8006 (HTTPS)
API Token Setup
  • Go to Datacenter → Permissions → API Tokens
  • Click "Add" and select a user (e.g., root@pam)
  • Enter a token ID (e.g., "proxui")
  • Uncheck "Privilege Separation" for full user permissions
  • Copy the token secret (shown only once!)