immutablue-lima-gen#

Generate Lima VM configuration files for Immutablue images.

Synopsis#

immutablue-lima-gen [OPTIONS]

Description#

immutablue-lima-gen creates Lima configuration files for testing Immutablue images locally in VMs. It detects available images and generates appropriate Lima YAML configs.

Options#

OptionDescription
--output-dir <PATH>Output directory (default: from settings)
--variant <NAME>Generate config 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:
    lima:
      path: "~/.local/share/immutablue/lima"

Examples#

Generate configs for all variants#

immutablue-lima-gen

Generate config for specific variant#

immutablue-lima-gen --variant immutablue

List available variants#

immutablue-lima-gen --list

Custom output directory#

immutablue-lima-gen --output-dir ~/my-lima-configs

Using Generated Configs#

After generating configs:

# Start the VM
limactl start ~/.local/share/immutablue/lima/immutablue.yaml

# Shell into the VM
limactl shell immutablue

# Stop the VM
limactl stop immutablue

# Delete the VM
limactl delete immutablue

Requirements#

  • Lima must be installed (brew install lima)
  • QEMU for virtualization

See Also#