LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

pvenode-config

get or set Proxmox VE node configuration options

TLDR

Get all node configuration options
$ pvenode config get
copy
Get a specific property
$ pvenode config get --property description
copy
Set the node description (notes panel)
$ pvenode config set --description "primary cluster node"
copy
Configure ACME domains for TLS certificates
$ pvenode config set --acme domains=pve.example.com
copy
Set Wake-on-LAN MAC address
$ pvenode config set --wakeonlan XX:XX:XX:XX:XX:XX
copy
Set first guest boot delay in seconds
$ pvenode config set --startall-onboot-delay 10
copy
Set RAM ballooning target percent
$ pvenode config set --ballooning-target 90
copy

SYNOPSIS

pvenode config get [OPTIONS]pvenode config set [OPTIONS]

DESCRIPTION

pvenode config reads and writes node-level configuration for a Proxmox VE host. Settings include notes/description, ACME certificate domains, Wake-on-LAN, automatic guest start delay, memory ballooning target, and geographic location metadata.These options affect the local node (not cluster-wide datacenter config). Certificate-related ACME domain settings work together with pvenode acme commands to order and renew TLS certificates used by the API and web UI.

PARAMETERS

--property name

(get) Return only a specific property: acme, acmedomain0–5, ballooning-target, description, location, startall-onboot-delay, wakeonlan (default: all)
--description text
(set) Node description shown in the web UI notes panel
--acme settings
(set) Node-specific ACME settings (account, domains)
--acmedomainn settings
(set) ACME domain and validation plugin for domain index n
--ballooning-target percent
(set) RAM usage target for ballooning, 0–100 (default 80)
--startall-onboot-delay seconds
(set) Delay before starting on-boot guests after host boot, 0–300 (default 0)
--wakeonlan settings
(set) Wake-on-LAN MAC and optional bind interface / broadcast address
--location settings
(set) Node location (latitude, longitude, optional name)
--delete list
(set) Settings to remove
--digest hash
(set) Prevent concurrent modifications if config digest differs

CAVEATS

Changing ACME domains does not by itself issue a certificate; you still need pvenode acme cert order (and typically a pveproxy restart). Concurrent edits can race; use --digest when scripting. Incorrect Wake-on-LAN settings will prevent remote power-on of sleeping nodes.

HISTORY

pvenode config is part of the Proxmox VE pvenode node management tool.

SEE ALSO

RESOURCES

Copied to clipboard
Kai