vm-images/README.md

vm-images

Shared, locally cached virtual-machine installation media and base images. Downloaded ISO, QCOW2, IMG, VHD, and VHDX files are intentionally excluded from Git.

Download images

Download every supported image:

./download-images.sh

Download or check selected targets:

./download-images.sh debian13
./download-images.sh almalinux10
./download-images.sh fedora44
./download-images.sh virtio-win

The Windows installation ISO is not downloaded because Microsoft's temporary download URLs expire. Supply it manually at the path reported by ./download-images.sh --print-path windows11 --iso.

Query image paths

The path interface prints one absolute path without downloading anything:

./download-images.sh --print-path debian13
./download-images.sh --print-path almalinux10
./download-images.sh --print-path fedora44
./download-images.sh --print-path virtio-win
./download-images.sh --print-path windows11
./download-images.sh --print-path windows11 --iso

The Windows target prints the QCOW2 path by default. Add --iso to print its manually supplied installation ISO path.

Download URLs can be overridden with DEBIAN_IMAGE_URL, ALMA_IMAGE_URL, FEDORA_IMAGE_URL, and VIRTIO_WIN_ISO_URL. The Fedora checksum can be overridden with FEDORA_IMAGE_SHA256 when using a custom image.