# 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`.