VIRT-CLOUD-BOOT(1)               User Commands              VIRT-CLOUD-BOOT(1)

NAME
       virt-cloud-boot - manual page for virt-cloud-boot 26.9

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

       [--fedora-uki VER] [--centos VER] [--rhel VER]
              [--alma 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] [--ufs |
              --no-ufs] [--ssh-port PORT] [--ssh-agent | --no-ssh-agent]

       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

       --alma VER
              boot almalinux 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)

       --ufs, --no-ufs
              use universal flash storage (default: no)

   network setup:
       --ssh-port PORT
              forward ssh connections to localhost:PORT to the guest

       --ssh-agent, --no-ssh-agent
              get public ssh keys from ssh agent (default: yes)

ENVIRONMENT
       VIRT_DISTRO_IMGDIR
              default cloud image directory

AUTHOR
       Gerd Hoffmann <kraxel@redhat.com>

virt-cloud-boot 26.9            September 2026              VIRT-CLOUD-BOOT(1)