create_vm
Create a Proxmox VE virtual machine that boots an ISO and automate Linux or Windows installs with profiles, user setup, and optional start.
Instructions
Create a VM that boots an ISO image (see list_install_media). Profiles: linux, win11 (UEFI, Secure Boot, TPM 2.0), win10, other. It gets a SPICE display, sound and a USB tablet. Windows (win11/win10) installs itself with windows_user: the app puts an answer file on a disc of its own — VirtIO drivers from virtio_iso, the edition, no setup questions, that user with a password the USER types in Proxmox Controller's window (you never give or see it), optionally Remote Desktop and the dark theme, and the VirtIO guest tools with the QEMU guest agent last; with start, the app presses Enter at the installer's 'Press any key to boot from CD' itself (it waits only seconds). The disc is deleted once Windows is ready. An Ubuntu Server ISO from 24.04 on (profile linux) installs itself with linux_user: autoinstall answers on a disc of the app's — that user with the password the USER types, optionally an SSH key and a static_ip, the whole disk, the QEMU guest agent, OpenSSH, the host's time zone; with start, the app types yes at the installer's 'Continue with autoinstall?' itself. About 15 minutes; the disc is deleted once the agent answers.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"host": "<host>",
"name": "<name>",
"iso": "<iso>",
"reason": "<reason>"
},
"name": "create_vm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iso | Yes | An ISO's volid. | |
| host | Yes | The host's id, from list_hosts. | |
| name | Yes | ||
| node | No | ||
| vmid | No | ||
| cores | No | ||
| start | No | ||
| bridge | No | ||
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| disk_gb | No | ||
| edition | No | As the installer lists it. Default: Windows 11 Pro (win10: Windows 10 Pro). Remote Desktop needs Pro, Education, Enterprise or Server. | |
| profile | No | ||
| storage | No | ||
| host_cpu | No | ||
| language | No | Such as en-US or el-GR. Default: from the ISO's name, else en-US. The keyboard is English (US). | |
| static_ip | No | With linux_user: a fixed address such as 192.168.1.50; the network's size, gateway and DNS are the host's own (on the VM's bridge). Default: DHCP. | |
| dark_theme | No | ||
| linux_user | No | An Ubuntu Server ISO installs itself with this user (sudo); the user types its password. | |
| memory_mib | No | ||
| virtio_iso | No | ||
| guest_agent | No | ||
| windows_user | No | Windows installs itself with this user (an administrator); the user types its password. | |
| start_at_boot | No | ||
| remote_desktop | No | ||
| ssh_public_key | No | With linux_user. |