Proxmox VE Create

Proxmox VE Create

Certified

Create an LXC container on Proxmox VE

Creates a new LXC container via POST /nodes/{node}/lxc. Defaults: 1 vCPU, 512 MiB RAM, rootfs on local-lvm: 4, bridge on vmbr0. Set powerOn to true to start the container after creation.

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

Create a container from a template

yaml
id: create_container
namespace: company.team

tasks:
  - id: create
    type: io.kestra.plugin.proxmox.container.Create
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    vmId: 300
    osTemplate: "local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.zst"
    hostname: my-container
    cores: 2
    memory: 1024
    rootfs: "local-lvm:8"
    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).

OS template

Storage path to the LXC template, e.g. local: vztmpl/ubuntu-22.04.tar.zst.

Container ID

Integer VMID to assign. Must be unique in the cluster.

Default1

Number of CPU cores

Defaults to 1.

Container hostname

Default512

Memory in MiB

Defaults to 512.

Defaultname=eth0,bridge=vmbr0,ip=dhcp

Network interface

LXC net string, e.g. name=eth0,bridge=vmbr0,ip=dhcp.

Password

Password for ticket-based authentication.

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

Default8006

API port

Defaults to 8006.

Defaultfalse

Start after creation

Defaults to false.

Defaultlocal-lvm:4

Root filesystem

Storage and size, e.g. local-lvm: 4.

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.

Defaulttrue

Unprivileged container

Create an unprivileged container. Defaults to true.

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