virt-cloud-boot - Man Page

manual page for virt-cloud-boot 26.8

Description

usage: virt-cloud-boot [-h] [--dry-run] [-i FILE] [--fedora VER]

[--fedora-uki VER] [--centos VER] [--rhel VER]

[--imgdir DIR] [-u USER] [--password PASSWD] [--package PKG] [--copy-file FILE] [--runcmd CMD] [--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]

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

--imgdir DIR

lookup fedora/centos/rhel images in DIR (default: /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

--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)

Environment

VIRT_DISTRO_IMGDIR

default cloud image directory

Author

Gerd Hoffmann <kraxel@redhat.com>

Info

August 2026 virt-cloud-boot 26.8