immutablue-qcow2-gen#

Generate qcow2 disk images from Immutablue container images.

Synopsis#

immutablue-qcow2-gen [OPTIONS]

Description#

immutablue-qcow2-gen converts Immutablue container images to qcow2 disk images suitable for use with QEMU, libvirt, or Lima VMs.

Options#

OptionDescription
--output-dir <PATH>Output directory (default: from settings)
--variant <NAME>Generate image for specific variant
--listList available variants
--help, -hShow help message

Default Output Directory#

The default output directory is configured via settings:

# settings.yaml
immutablue:
  gen:
    qcow2:
      path: "~/.local/share/immutablue/images"

Examples#

Generate image for default variant#

immutablue-qcow2-gen

Generate image for specific variant#

immutablue-qcow2-gen --variant cyan

List available variants#

immutablue-qcow2-gen --list

Custom output directory#

immutablue-qcow2-gen --output-dir ~/vm-images

Using Generated Images#

With QEMU directly#

qemu-system-x86_64 \
    -enable-kvm \
    -m 4G \
    -drive file=~/.local/share/immutablue/images/immutablue.qcow2,format=qcow2

With virt-manager#

  1. Open virt-manager
  2. Create new VM → Import existing disk image
  3. Select the generated qcow2 file
  4. Configure CPU/memory as needed

With Lima#

Use immutablue-lima-gen instead for Lima-specific configs that reference qcow2 images.

Requirements#

  • Podman or Docker
  • Sufficient disk space for images (~10GB per variant)

See Also#