Reference

virt-cloud-boot(1)

manual page for virt-cloud-boot 26.10

NAME

virt-cloud-boot - manual page for virt-cloud-boot 26.10

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 <[email protected]>