Proxmox VE Migrate

Proxmox VE Migrate

Certified

Migrate a QEMU virtual machine to another Proxmox VE node

Initiates a live or offline migration of a QEMU VM to a target node via POST /nodes/{node}/qemu/{vmid}/migrate and waits for completion.

yaml
type: io.kestra.plugin.proxmox.vm.Migrate

Migrate a VM to another node

yaml
id: migrate_vm
namespace: company.team

tasks:
  - id: migrate
    type: io.kestra.plugin.proxmox.vm.Migrate
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    vmName: my-vm
    targetNode: pve2
Properties

Proxmox host

Hostname or IP address of the Proxmox VE node (no scheme, no port).

Proxmox node name

Name of the cluster node that scopes all API calls (e.g. pve, node1).

Target node

Name of the destination Proxmox node.

VM name or ID

Either a VM name (resolved at runtime) or an integer VMID.

Password

Password for ticket-based authentication.

Reference (ref) of the pluginDefaults to apply to this task.

Default8006

API port

Defaults to 8006.

API token ID

Full token identifier in the form user@realm!tokenname (e.g. root@pam!mytoken). Use together with tokenSecret.

API token secret

The UUID secret associated with the token ID.

Username

PAM or PVE user in the form user@realm (e.g. root@pam). Required when using ticket-based auth.

Defaulttrue

Verify SSL

Validate the server TLS certificate. Defaults to true; set to false only for trusted networks with self-signed Proxmox certificates.