| VIRT-CLOUD-BOOT(1) | User Commands | VIRT-CLOUD-BOOT(1) |
NAME
virt-cloud-boot - manual page for virt-cloud-boot 26.8.1
DESCRIPTION
usage: virt-cloud-boot [-h] [--dry-run] [-i FILE] [--fedora VER]
- [--fedora-uki VER] [--centos VER] [--rhel VER]
- [--ubuntu VER] [--imgdir DIR] [--list] [-u USER] [--password PASSWD] [--package PKG] [--copy-file FILE] [--runcmd CMD] [--no-uefi] [--smm] [--qemu-vars] [--secure-boot] [--cc-mode {none,sev,snp,tdx}] [--sev] [--snp] [--tdx] [--log FILE] [--memory MEM] [--smp CPUS] [--scsi | --no-scsi] [--sata | --no-sata] [--nvme | --no-nvme] [--vblk | --no-vblk]
boot cloud image
options:
- -h, --help
- show this help message and exit
- --dry-run, --dryrun
- print generated qemu command line and quit
select cloud image:
- -i, --image FILE
- boot cloud image FILE
- --fedora VER
- boot fedora VER
- --fedora-uki VER
- boot fedora VER (uki variant)
- --centos VER
- boot centos stream VER
- --rhel VER
- boot rhel VER
- --ubuntu VER
- boot ubuntu VER
- --imgdir DIR
- lookup fedora/centos/rhel images in DIR (default: /vmdisk/iso/distro)
- --list
- list cloud images in /vmdisk/iso/distro
setup cloud image:
- -u, --username, --user USER
- login username (default: cloud)
- --password, --passwd PASSWD
- login password (default: cloud)
- --package, --rpm PKG
- install package PKG
- --copy-file FILE
- copy FILE into the guest
- --runcmd CMD
- run CMD in guest
firmware setup:
- --no-uefi
- skip uefi firmware setup (boot with qemu default firmware)
- --smm
- use smm firmware builds (feature "require-smm")
- --qemu-vars, --qemuvars
- use qemu uefi vars (feature "host-uefi-vars")
- --secure-boot, --sb
- enable secure boot (feature "enrolled-keys")
- --cc-mode {none,sev,snp,tdx}
- set confidential computing mode (default: none)
- --sev
- enable sev cc mode (feature "amd-sev")
- --snp
- enable snp cc mode (feature "amd-sev-snp")
- --tdx
- enable tdx cc mode (feature "intel-tdx")
- --log FILE
- write firmware log to FILE
hardware setup:
- --memory, --mem MEM
- assign guest memory (default: 4G)
- --smp CPUS
- assign guest vcpus (default: 1)
- --scsi, --no-scsi
- use virtio scsi (default: yes)
- --sata, --no-sata
- use sata (q35 only, default: no)
- --nvme, --no-nvme
- use NVMe emulation (default: no)
- --vblk, --no-vblk
- use virtio block (default: no)
ENVIRONMENT
- VIRT_DISTRO_IMGDIR
- default cloud image directory
AUTHOR
Gerd Hoffmann <kraxel@redhat.com>
| August 2026 | virt-cloud-boot 26.8.1 |