Proxmox VE Clone

Proxmox VE Clone

Certified

Clone a QEMU virtual machine on Proxmox VE

Clones an existing QEMU VM to a new VMID via POST /nodes/{node}/qemu/{vmid}/clone. Set full=true to create a full independent clone instead of a linked clone.

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

Clone a VM

yaml
id: clone_vm
namespace: company.team

tasks:
  - id: clone
    type: io.kestra.plugin.proxmox.vm.Clone
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    vmName: template-vm
    newId: 201
    newName: cloned-vm
    full: true
Properties

Proxmox host

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

New VM ID

VMID to assign to the clone.

Proxmox node name

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

Source VM name or ID

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

Defaultfalse

Full clone

Set true to create a full independent clone. Defaults to false (linked clone).

New VM name

Password

Password for ticket-based authentication.

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

Default8006

API port

Defaults to 8006.

Target node

Destination node for the clone. Defaults to the same node as the source.

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.