Interface: VmRunArgs
Arguments for a vm/run / cvm/run hypervisor operation — a declarative façade over the VM orchestrator that mirrors container/run (the QEMU knobs are hidden). cvm/run is the confidential (SEV-SNP) variant and shares this exact arg shape: the operation key selects confidentiality, not an argument.
Properties
| Property | Type | Description |
|---|---|---|
cmd? | string | string[] | Command to run on boot (delivered via cloud-init / the guest agent). |
cpu? | number | vCPU count. |
disk? | string | number | Root disk size — MiB as a number, or a human string like "20G". |
env? | Env | Environment variables injected into the guest. |
expose? | Expose | Ports to expose — same grammar as container/run. |
gpu? | boolean | Pass a GPU through to the guest (VFIO). |
image | string | Disk image to fetch and boot (OCI artifact, URL, or IPFS CID). Required. |
memory? | string | number | Memory — MiB as a number, or a human string like "4G". |
private? | boolean | Publish exposed URLs privately (auth-gated) rather than publicly. |
restart_policy? | RestartPolicy | Restart policy — same grammar as container/run. |