pvecm
TLDR
Add the current node to an existing cluster
SYNOPSIS
pvecm command [options]
DESCRIPTION
pvecm manages Proxmox VE cluster membership. It handles creating clusters, joining nodes to existing clusters, and removing nodes. The cluster provides high availability, live migration, and shared storage capabilities.
Proxmox clustering uses corosync for cluster communication and pmxcfs for distributed configuration storage. All cluster nodes share the same configuration.
PARAMETERS
add host
Join this node to existing clusteraddnode, addn node
Add node to cluster config (internal use)apiver, ap
Show cluster join API versioncreate, c name
Create new cluster with given namedelnode, d node
Remove node from cluster configurationnodes, n
List cluster nodesstatus, s
Show cluster statusexpected votes
Set expected votes for quorum
CAVEATS
Creating a cluster is irreversible without reinstalling. Removing nodes requires the node to be offline and clean shutdown procedures. Network configuration must allow cluster communication (default port 5405-5412).
HISTORY
Part of Proxmox VE, enabling multi-node deployments with shared management. Built on corosync cluster engine and provides foundation for high-availability features.
SEE ALSO
pvesh(1), qm(1), pct(1), ha-manager(1)
