Initial commit

README.md

@@ -0,0 +1,43 @@
+# 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:
+
+```bash
+./download-images.sh
+```
+
+Download or check selected targets:
+
+```bash
+./download-images.sh debian13
+./download-images.sh almalinux10
+./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:
+
+```bash
+./download-images.sh --print-path debian13
+./download-images.sh --print-path almalinux10
+./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`,
+and `VIRTIO_WIN_ISO_URL`.