---
name: "virt-cloud-boot"
section: "1"
platform: "linux"
package: "virt-firmware"
version: "26.10-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/virt-cloud-boot"
---

# 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 \<kraxel@redhat.com\>