Skip to content

Cloud-Init Data Recognized

cloud-init-pve only recognizes the subset of cloud-init data that Proxmox uses in its default configuration: user-data and network-config, read from the NoCloud config drive Proxmox attaches to the VM.

User data

Field Handling
chpasswd Ignored.
fqdn Applied only on the first run.
hostname Ignored in favor of fqdn.
package_upgrade Honored only on the first run.
password If set, update the user's password to this value, which Proxmox VE always writes as an already-hashed (crypt) string rather than plaintext.
ssh_authorized_keys Added to the user's authorized_keys (see Backends).
user If set, create a user with that name; otherwise use the template's default user.
users Ignored.

Network data

If an interface is not listed, it is left untouched — no configuration change is applied to it.

type: physical

Field Handling
name Rename the interface to this name.
mac_address Used to match the interface.
subnets IPv4 and IPv6 config applied to the interface.

type: nameserver

Field Handling
address List of nameserver addresses.
search List of domains searched for unqualified names.