Proxmox VE Create

Proxmox VE Create

Certified

Create a QEMU virtual machine on Proxmox VE

Creates a new QEMU VM via POST /nodes/{node}/qemu. Defaults: 1 vCPU, 1024 MiB RAM, 8 GiB disk (virtio on local-lvm), bridge net0 on vmbr0. Set powerOn to true to start the VM immediately after creation.

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

Create a VM and start it

yaml
id: create_vm
namespace: company.team

tasks:
  - id: create
    type: io.kestra.plugin.proxmox.vm.Create
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    vmId: 200
    vmName: my-new-vm
    cores: 2
    memory: 2048
    disk: "local-lvm:16"
    net: "virtio,bridge=vmbr0"
    powerOn: true
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).

VMID

Integer ID to assign to the new VM. Must be unique in the cluster.

VM name

Name to assign to the new VM.

Default1

Number of CPU cores

Defaults to 1.

Defaultlocal-lvm:8

Disk specification

Proxmox disk string, e.g. local-lvm: 8 for an 8 GiB virtio disk on local-lvm storage.

Default1024

Memory in MiB

Defaults to 1024.

Defaultvirtio,bridge=vmbr0

Network interface specification

Proxmox net string, e.g. virtio,bridge=vmbr0.

OS template / ISO

Optional path to a cloud-init image or ISO on the node's storage, e.g. local: iso/ubuntu-24.04.iso.

Password

Password for ticket-based authentication.

Default8006

API port

Defaults to 8006.

Defaultfalse

Start after creation

Defaults to false.

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.

More Plugins in this Category

VMware (EE)
VMware
Enterprise

Tasks that automate VMware vSphere operations within Kestra workflows.

Infrastructure

33 tasks

3 blueprints

Canonical (EE)
Canonical
Enterprise

Tasks to interact with Canonical services, enabling automation and infrastructure management through API-driven workflows.

CloudInfrastructure

5 tasks