LinuxCommandLibrary

pvecm

Proxmox cluster membership management

TLDR

Add the current node to an existing cluster

$ pvecm add [hostname_or_ip]
copy
Add a node to the cluster configuration
$ pvecm addnode [node]
copy
Display the API version available on this node
$ pvecm apiver
copy
Generate new cluster configuration
$ pvecm create [clustername]
copy
Remove a node from the cluster
$ pvecm delnode [node]
copy
Display the nodes in the cluster
$ pvecm nodes
copy
Display the cluster status
$ pvecm status
copy

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 cluster
addnode, addn node
Add node to cluster config (internal use)
apiver, ap
Show cluster join API version
create, c name
Create new cluster with given name
delnode, d node
Remove node from cluster configuration
nodes, n
List cluster nodes
status, s
Show cluster status
expected 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)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community