VIRT-CLOUD-BOOT(1)

💅 NAME 💅

ok so virt-cloud-boot — it's the manual page for virt-cloud-boot version 26.10, bestie. that's the whole name section, we move 🫶

---

✨ DESCRIPTION ✨

hi bestie, here's the vibe: this is how you call it 👇

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]

and like, what does it do? it boots a cloud image. that's it. that's the whole job. iconic behavior honestly 👑

---

🎀 options: 🎀

• -h, --help — prints this help message and dips, nothing else happens 💖
• --dry-run, --dryrun — just prints the generated qemu command line and quits, so you can vibe check it before actually committing 😌

---

🌸 select cloud image: 🌸

• -i, --image FILE — boots the cloud image at FILE, no cap 🦋
• --fedora VER — boots fedora VER
• --fedora-uki VER — boots fedora VER, but the uki variant this time ✨
• --centos VER — boots centos stream VER
• --rhel VER — boots rhel VER
• --alma VER — boots almalinux VER
• --ubuntu VER — boots ubuntu VER
• --imgdir DIR — looks up the fedora/centos/rhel images in DIR (default: /vmdisk/iso/distro) 📁
• --list — lists the cloud images sitting in /vmdisk/iso/distro 🧚

---

💜 setup cloud image: 💜

• -u, --username, --user USER — the login username (default: cloud)
• --password, --passwd PASSWD — the login password (default: cloud)
• --package, --rpm PKG — installs package PKG
• --copy-file FILE — copies FILE into the guest 🫶
• --runcmd CMD — runs CMD in the guest

---

🔥 firmware setup: 🔥

• --no-uefi — skips the uefi firmware setup entirely (boots with qemu's default firmware instead)
• --smm — uses the smm firmware builds (feature "require-smm")
• --qemu-vars, --qemuvars — uses qemu uefi vars (feature "host-uefi-vars")
• --secure-boot, --sb — enables secure boot (feature "enrolled-keys")
• --cc-mode {none,sev,snp,tdx} — sets the confidential computing mode (default: none)
• --sev — enables sev cc mode (feature "amd-sev")
• --snp — enables snp cc mode (feature "amd-sev-snp")
• --tdx — enables tdx cc mode (feature "intel-tdx")
• --log FILE — writes the firmware log to FILE 📝

---

⭐ hardware setup: ⭐

• --memory, --mem MEM — assigns guest memory (default: 4G)
• --smp CPUS — assigns guest vcpus (default: 1)
• --scsi, --no-scsi — uses virtio scsi (default: yes)
• --sata, --no-sata — uses sata (q35 only, default: no) ⚠️
• --nvme, --no-nvme — uses NVMe emulation (default: no)
• --vblk, --no-vblk — uses virtio block (default: no)
• --ufs, --no-ufs — uses universal flash storage (default: no)

---

🦋 network setup: 🦋

• --ssh-port PORT — forwards ssh connections to localhost:PORT into the guest
• --ssh-agent, --no-ssh-agent — grabs public ssh keys from the ssh agent (default: yes) 🔑

---

🌈 ENVIRONMENT 🌈

• VIRT_DISTRO_IMGDIR — sets the default cloud image directory 🗂️

---

👑 AUTHOR 👑

shoutout to Gerd Hoffmann <kraxel@redhat.com> — the main character who made this fr fr 💖

---

ok bestie that's the whole page, every flag accounted for, no crumbs left 🍓

and finally, the cute lil sign-off: this whole thing is virt-cloud-boot 26.10, dated October 2026, and it's filed under VIRT-CLOUD-BOOT(1) in the User Commands section. slay, go boot something 💅✨