Merge pull request #1707 from AkihiroSuda/dev

AkihiroSuda · web-flow · commit 6deae73e8082 · 2023-08-03T04:39:08.000+09:00
Update docs (hint for `softwareupdate --install-rosetta `, `socketfilterfw --unblock /usr/libexec/bootpd`, more `s/example/template/`)
diff --git a/README.md b/README.md
@@ -159,7 +159,7 @@ $ limactl start
 ? Creating an instance "default"  [Use arrows to move, type to filter]
 > Proceed with the current configuration
   Open an editor to review or modify the current configuration
-  Choose another example (docker, podman, archlinux, fedora, ...)
+  Choose another template (docker, podman, archlinux, fedora, ...)
   Exit
 ...
 INFO[0029] READY. Run `lima` to open the shell.
@@ -189,7 +189,7 @@ $ limactl start --list-templates
 
 To create an instance "default" from a local file:
 ```console
-$ limactl start --name=default /usr/local/share/lima/examples/fedora.yaml
+$ limactl start --name=default /usr/local/share/lima/templates/fedora.yaml
 ```
 
 To create an instance "default" from a remote URL (use carefully, with a trustable source):
@@ -310,27 +310,30 @@ The current default spec:
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 ### Generic
 
-- [Generic](#generic)
-  - ["What's my login password?"](#whats-my-login-password)
-  - ["Does Lima work on ARM Mac?"](#does-lima-work-on-arm-mac)
-  - ["Can I run non-Ubuntu guests?"](#can-i-run-non-ubuntu-guests)
-  - ["Can I run other container engines such as Docker and Podman? What about Kubernetes?"](#can-i-run-other-container-engines-such-as-docker-and-podman-what-about-kubernetes)
-  - ["Can I run Lima with a remote Linux machine?"](#can-i-run-lima-with-a-remote-linux-machine)
-  - ["Advantages compared to Docker for Mac?"](#advantages-compared-to-docker-for-mac)
-- [QEMU](#qemu)
-  - ["QEMU crashes with `HV_ERROR`"](#qemu-crashes-with-hv_error)
-  - ["QEMU is slow"](#qemu-is-slow)
-  - [error "killed -9"](#error-killed--9)
-  - ["QEMU crashes with `vmx_write_mem: mmu_gva_to_gpa XXXXXXXXXXXXXXXX failed`"](#qemu-crashes-with-vmx_write_mem-mmu_gva_to_gpa-xxxxxxxxxxxxxxxx-failed)
-- [Networking](#networking)
-  - ["Cannot access the guest IP 192.168.5.15 from the host"](#cannot-access-the-guest-ip-192168515-from-the-host)
-  - ["Ping shows duplicate packets and massive response times"](#ping-shows-duplicate-packets-and-massive-response-times)
-- [Filesystem sharing](#filesystem-sharing)
-  - ["Filesystem is slow"](#filesystem-is-slow)
-  - ["Filesystem is not writable"](#filesystem-is-not-writable)
-- [External projects](#external-projects)
-  - ["I am using Rancher Desktop. How to deal with the underlying Lima?"](#i-am-using-rancher-desktop-how-to-deal-with-the-underlying-lima)
-- ["Hints for debugging other problems?"](#hints-for-debugging-other-problems)
+  - [Generic](#generic)
+    - ["What's my login password?"](#whats-my-login-password)
+    - ["Does Lima work on ARM Mac?"](#does-lima-work-on-arm-mac)
+    - ["Can I run non-Ubuntu guests?"](#can-i-run-non-ubuntu-guests)
+    - ["Can I run other container engines such as Docker and Podman? What about Kubernetes?"](#can-i-run-other-container-engines-such-as-docker-and-podman-what-about-kubernetes)
+    - ["Can I run Lima with a remote Linux machine?"](#can-i-run-lima-with-a-remote-linux-machine)
+    - ["Advantages compared to Docker for Mac?"](#advantages-compared-to-docker-for-mac)
+  - [QEMU](#qemu)
+    - ["QEMU crashes with `HV_ERROR`"](#qemu-crashes-with-hv_error)
+    - ["QEMU is slow"](#qemu-is-slow)
+    - [error "killed -9"](#error-killed--9)
+    - ["QEMU crashes with `vmx_write_mem: mmu_gva_to_gpa XXXXXXXXXXXXXXXX failed`"](#qemu-crashes-with-vmx_write_mem-mmu_gva_to_gpa-xxxxxxxxxxxxxxxx-failed)
+- [VZ](#vz)
+    - ["Liam gets stuck at `Installing rosetta...`"](#liam-gets-stuck-at-installing-rosetta)
+  - [Networking](#networking)
+    - ["Cannot access the guest IP 192.168.5.15 from the host"](#cannot-access-the-guest-ip-192168515-from-the-host)
+    - ["Ping shows duplicate packets and massive response times"](#ping-shows-duplicate-packets-and-massive-response-times)
+    - ["IP address is not assigined for vmnet networks"](#ip-address-is-not-assigined-for-vmnet-networks)
+  - [Filesystem sharing](#filesystem-sharing)
+    - ["Filesystem is slow"](#filesystem-is-slow)
+    - ["Filesystem is not writable"](#filesystem-is-not-writable)
+  - [External projects](#external-projects)
+    - ["I am using Rancher Desktop. How to deal with the underlying Lima?"](#i-am-using-rancher-desktop-how-to-deal-with-the-underlying-lima)
+  - ["Hints for debugging other problems?"](#hints-for-debugging-other-problems)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 ### Generic
@@ -440,6 +443,11 @@ A workaround is to set environment variable `QEMU_SYSTEM_X86_64="qemu-system-x86
 
 https://bugs.launchpad.net/qemu/+bug/1838390
 
+## VZ
+#### "Liam gets stuck at `Installing rosetta...`"
+
+Try `softwareupdate --install-rosetta` from a terminal.
+
 ### Networking
 #### "Cannot access the guest IP 192.168.5.15 from the host"
 
@@ -463,6 +471,13 @@ PING google.com (172.217.165.14): 56 data bytes
 
 For more details, see [Documentation/Networking](https://wiki.qemu.org/Documentation/Networking#User_Networking_.28SLIRP.29).
 
+#### "IP address is not assigined for vmnet networks"
+Try the following commands:
+```bash
+/usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/libexec/bootpd
+/usr/libexec/ApplicationFirewall/socketfilterfw --unblock /usr/libexec/bootpd
+```
+
 ### Filesystem sharing
 #### "Filesystem is slow"
 Try virtiofs. See [`docs/mount.md`](./docs/mount.md)
diff --git a/cmd/limactl/start.go b/cmd/limactl/start.go
@@ -340,7 +340,7 @@ func chooseNextCreatorState(st *creatorState) (*creatorState, error) {
 			Options: []string{
 				"Proceed with the current configuration",
 				"Open an editor to review or modify the current configuration",
-				"Choose another example (docker, podman, archlinux, fedora, ...)",
+				"Choose another template (docker, podman, archlinux, fedora, ...)",
 				"Exit",
 			},
 		}
@@ -370,26 +370,26 @@ func chooseNextCreatorState(st *creatorState) (*creatorState, error) {
 				return st, errors.New("should not reach here")
 			}
 			return st, nil
-		case prompt.Options[2]: // "Choose another example..."
-			examples, err := templatestore.Templates()
+		case prompt.Options[2]: // "Choose another template..."
+			templates, err := templatestore.Templates()
 			if err != nil {
 				return st, err
 			}
 			var ansEx int
 			promptEx := &survey.Select{
-				Message: "Choose an example",
-				Options: make([]string, len(examples)),
+				Message: "Choose a template",
+				Options: make([]string, len(templates)),
 			}
-			for i := range examples {
-				promptEx.Options[i] = examples[i].Name
+			for i := range templates {
+				promptEx.Options[i] = templates[i].Name
 			}
 			if err := survey.AskOne(promptEx, &ansEx); err != nil {
 				return st, err
 			}
-			if ansEx > len(examples)-1 {
-				return st, fmt.Errorf("invalid answer %d for %d entries", ansEx, len(examples))
+			if ansEx > len(templates)-1 {
+				return st, fmt.Errorf("invalid answer %d for %d entries", ansEx, len(templates))
 			}
-			yamlPath := examples[ansEx].Location
+			yamlPath := templates[ansEx].Location
 			st.instName, err = guessarg.InstNameFromYAMLPath(yamlPath)
 			if err != nil {
 				return nil, err
diff --git a/docs/network.md b/docs/network.md
@@ -141,6 +141,13 @@ The network daemon is started automatically when the first instance referencing
 and will stop automatically once the last instance has stopped. Daemon logs will be stored in the
 `$LIMA_HOME/_networks` directory.
 
+The IP address is automatically assigned by macOS's bootpd.
+If the IP address is not assigned, try the following commands:
+```bash
+/usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/libexec/bootpd
+/usr/libexec/ApplicationFirewall/socketfilterfw --unblock /usr/libexec/bootpd
+```
+
 #### Unmanaged
 For Lima >= 0.12:
 ```yaml
diff --git a/examples/almalinux-8.yaml b/examples/almalinux-8.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.8.3 or later.
+# This template requires Lima v0.8.3 or later.
 
 # NOTE: EL8-based distros are known not to work on M1 chips: https://github.com/lima-vm/lima/issues/841
 # EL9-based distros are known to work.
diff --git a/examples/almalinux-9.yaml b/examples/almalinux-9.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.11.1 or later.
+# This template requires Lima v0.11.1 or later.
 
 images:
 - location: "https://repo.almalinux.org/almalinux/9.2/cloud/x86_64/images/AlmaLinux-9-GenericCloud-9.2-20230513.x86_64.qcow2"
diff --git a/examples/alpine.yaml b/examples/alpine.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 # Using the Alpine 3.18 aarch64 image with vmType=vz requires macOS Ventura 13.3 or later.
 
 images:
diff --git a/examples/apptainer-rootful.yaml b/examples/apptainer-rootful.yaml
@@ -1,4 +1,4 @@
-# Example to use Apptainer instead of containerd & nerdctl
+# A template to use Apptainer instead of containerd & nerdctl
 # $ limactl start ./apptainer-rootful.yaml
 # $ limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine
 
diff --git a/examples/apptainer.yaml b/examples/apptainer.yaml
@@ -1,4 +1,4 @@
-# Example to use Apptainer instead of containerd & nerdctl
+# A template to use Apptainer instead of containerd & nerdctl
 # $ limactl start ./apptainer.yaml
 # $ limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine
 
diff --git a/examples/archlinux.yaml b/examples/archlinux.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.7.0 or later
+# This template requires Lima v0.7.0 or later
 images:
 # Try to use yyyyMMdd.REV image if available. Note that yyyyMMdd.REV will be removed after several months.
 - location: "https://geo.mirror.pkgbuild.com/images/v20230715.165098/Arch-Linux-x86_64-cloudimg-20230715.165098.qcow2"
diff --git a/examples/buildkit.yaml b/examples/buildkit.yaml
@@ -1,4 +1,4 @@
-# Example to use BuildKit
+# A template to use BuildKit
 # $ limactl start ./buildkit.yaml
 
 # To run `buildkit` on the host (assumes buildctl is installed):
diff --git a/examples/centos-stream-8.yaml b/examples/centos-stream-8.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.8.3 or later.
+# This template requires Lima v0.8.3 or later.
 
 # NOTE: EL8-based distros are known not to work on M1 chips: https://github.com/lima-vm/lima/issues/841
 # EL9-based distros are known to work.
diff --git a/examples/centos-stream-9.yaml b/examples/centos-stream-9.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.11.1 or later.
+# This template requires Lima v0.11.1 or later.
 
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
diff --git a/examples/debian-11.yaml b/examples/debian-11.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.7.0 or later
+# This template requires Lima v0.7.0 or later
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud.debian.org/images/cloud/bullseye/20230717-1444/debian-11-genericcloud-amd64-20230717-1444.qcow2"
diff --git a/examples/debian-12.yaml b/examples/debian-12.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.7.0 or later
+# This template requires Lima v0.7.0 or later
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud.debian.org/images/cloud/bookworm/2023230723-1450/debian-12-genericcloud-amd64-2023230723-1450.qcow2"
diff --git a/examples/deprecated/centos-7.yaml b/examples/deprecated/centos-7.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.10.0 or later.
+# This template requires Lima v0.10.0 or later.
 # WARNING: RHEL-like below version 8 is unsupported, use at your own risk!
 images:
 - location: "https://cloud.centos.org/altarch/7/images/CentOS-7-x86_64-GenericCloud-2009.qcow2"
diff --git a/examples/docker-rootful.yaml b/examples/docker-rootful.yaml
@@ -1,12 +1,12 @@
-# Example to use Docker (rootful) instead of containerd & nerdctl
+# A template to use Docker (rootful) instead of containerd & nerdctl
 # $ limactl start ./docker-rootful.yaml
 # $ limactl shell docker-roootful docker run -it -v $HOME:$HOME --rm alpine
 
 # To run `docker` on the host (assumes docker-cli is installed):
 # $ export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock')
 # $ docker ...
 
-# This example requires Lima v0.8.0 or later
+# This template requires Lima v0.8.0 or later
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release-20230729/ubuntu-22.04-server-cloudimg-amd64.img"
diff --git a/examples/docker.yaml b/examples/docker.yaml
@@ -1,12 +1,12 @@
-# Example to use Docker instead of containerd & nerdctl
+# A template to use Docker instead of containerd & nerdctl
 # $ limactl start ./docker.yaml
 # $ limactl shell docker docker run -it -v $HOME:$HOME --rm alpine
 
 # To run `docker` on the host (assumes docker-cli is installed):
 # $ export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock')
 # $ docker ...
 
-# This example requires Lima v0.8.0 or later
+# This template requires Lima v0.8.0 or later
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release-20230729/ubuntu-22.04-server-cloudimg-amd64.img"
diff --git a/examples/experimental/9p.yaml b/examples/experimental/9p.yaml
@@ -1,6 +1,6 @@
-# This example requires Lima v0.10.0 or later.
+# This template requires Lima v0.10.0 or later.
 # On macOS hosts, QEMU needs to be v7.0.0 or later. Homebrew's QEMU v6.2.0_1 can be used too.
-# This example is planned to be merged to default.yaml in Lima v1.0 (ETA: 2022 Q2).
+# This template is planned to be merged to default.yaml in Lima v1.0 (ETA: 2022 Q2).
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud-images.ubuntu.com/releases/23.04/release-20230729/ubuntu-23.04-server-cloudimg-amd64.img"
diff --git a/examples/experimental/armv7l.yaml b/examples/experimental/armv7l.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.17.0 or later.
+# This template requires Lima v0.17.0 or later.
 
 arch: "armv7l"
 images:
diff --git a/examples/experimental/net-user-v2.yaml b/examples/experimental/net-user-v2.yaml
@@ -1,5 +1,5 @@
-# Example to run lima instance with experimental user-v2 network enabled
-# This example requires Lima v0.16.0 or later.
+# A template to run lima instance with experimental user-v2 network enabled
+# This template requires Lima v0.16.0 or later.
 images:
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img"
   arch: "x86_64"
diff --git a/examples/experimental/opensuse-tumbleweed.yaml b/examples/experimental/opensuse-tumbleweed.yaml
@@ -1,7 +1,7 @@
 # NOTE: Tumbleweed image is known to be broken as of April 2023:
 # https://github.com/lima-vm/lima/issues/1496
 #
-# This example requires Lima v0.11.3 or later
+# This template requires Lima v0.11.3 or later
 images:
 # Hint: run `limactl prune` to invalidate the "Current" cache
 - location: "https://download.opensuse.org/tumbleweed/appliances/openSUSE-Tumbleweed-Minimal-VM.x86_64-Cloud.qcow2"
diff --git a/examples/experimental/riscv64.yaml b/examples/experimental/riscv64.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.11.0 or later.
+# This template requires Lima v0.11.0 or later.
 
 arch: "riscv64"
 images:
diff --git a/examples/experimental/rke2.yaml b/examples/experimental/rke2.yaml
@@ -12,7 +12,7 @@
 #
 # For more details of RKE2, please refer to https://docs.rke2.io/
 #
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 
 
 images:
@@ -30,7 +30,7 @@ images:
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-arm64.img"
   arch: "aarch64"
 
-# Mounts are disabled in this example, but can be enabled optionally.
+# Mounts are disabled in this template, but can be enabled optionally.
 mounts: []
 
 # containerd is managed by rke2, not by Lima, so the values are set to false here.
diff --git a/examples/experimental/virtiofs-linux.yaml b/examples/experimental/virtiofs-linux.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.17.0 or later, running on Linux with:
+# This template requires Lima v0.17.0 or later, running on Linux with:
 # - QEMU v4.2.0 or later.
 # - virtiofsd's Rust implementation: https://gitlab.com/virtio-fs/virtiofsd
 #   The QEMU version (qemu-virtiofsd) will *not* work, as it requires root access
diff --git a/examples/experimental/vz.yaml b/examples/experimental/vz.yaml
@@ -1,5 +1,5 @@
-# Example to run ubuntu using vmType: vz instead of qemu (Default)
-# This example requires Lima v0.14.0 or later and macOS 13.
+# A template to run ubuntu using vmType: vz instead of qemu (Default)
+# This template requires Lima v0.14.0 or later and macOS 13.
 vmType: "vz"
 rosetta:
   # Enable Rosetta for Linux.
diff --git a/examples/faasd.yaml b/examples/faasd.yaml
@@ -3,7 +3,7 @@
 # It can be accessed from the host by authenticating with faas-cli;
 # the ports are already forwarded automatically by lima.
 #
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 
 message: |
   # Get the faas-cli from one of following sources:
@@ -40,7 +40,7 @@ images:
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-arm64.img"
   arch: "aarch64"
 
-# Mounts are disabled in this example, but can be enabled optionally.
+# Mounts are disabled in this template, but can be enabled optionally.
 mounts: []
 
 # containerd is installed by the faasd installer script, not by Lima, so the values are set to false here.
diff --git a/examples/fedora.yaml b/examples/fedora.yaml
@@ -1,4 +1,4 @@
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 images:
 - location: "https://download.fedoraproject.org/pub/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2"
   arch: "x86_64"
diff --git a/examples/k3s.yaml b/examples/k3s.yaml
@@ -10,7 +10,7 @@
 # NAME       STATUS   ROLES                  AGE   VERSION
 # lima-k3s   Ready    control-plane,master   69s   v1.21.1+k3s1
 #
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
@@ -27,7 +27,7 @@ images:
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-arm64.img"
   arch: "aarch64"
 
-# Mounts are disabled in this example, but can be enabled optionally.
+# Mounts are disabled in this template, but can be enabled optionally.
 mounts: []
 
 # containerd is managed by k3s, not by Lima, so the values are set to false here.
diff --git a/examples/k8s.yaml b/examples/k8s.yaml
@@ -10,7 +10,7 @@
 # NAME       STATUS   ROLES                  AGE   VERSION
 # lima-k8s   Ready    control-plane,master   44s   v1.22.3
 
-# This example requires Lima v0.7.0 or later.
+# This template requires Lima v0.7.0 or later.
 images:
 # Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release-20230729/ubuntu-22.04-server-cloudimg-amd64.img"
@@ -26,7 +26,7 @@ images:
 - location: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-arm64.img"
   arch: "aarch64"
 
-# Mounts are disabled in this example, but can be enabled optionally.
+# Mounts are disabled in this template, but can be enabled optionally.
 mounts: []
 containerd:
   system: true
diff --git a/examples/nomad.yaml b/examples/nomad.yaml
diff --git a/examples/opensuse.yaml b/examples/opensuse.yaml
diff --git a/examples/oraclelinux-8.yaml b/examples/oraclelinux-8.yaml
diff --git a/examples/oraclelinux-9.yaml b/examples/oraclelinux-9.yaml
diff --git a/examples/podman-rootful.yaml b/examples/podman-rootful.yaml
diff --git a/examples/podman.yaml b/examples/podman.yaml
diff --git a/examples/rocky-8.yaml b/examples/rocky-8.yaml
diff --git a/examples/rocky-9.yaml b/examples/rocky-9.yaml
diff --git a/examples/ubuntu-lts.yaml b/examples/ubuntu-lts.yaml
diff --git a/examples/ubuntu.yaml b/examples/ubuntu.yaml
diff --git a/examples/vmnet.yaml b/examples/vmnet.yaml
diff --git a/hack/test-templates/test-misc.yaml b/hack/test-templates/test-misc.yaml
diff --git a/pkg/vz/rosetta_directory_share_arm64.go b/pkg/vz/rosetta_directory_share_arm64.go

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This example requires Lima v0.8.3 or later.`
	`1`	`+# This template requires Lima v0.8.3 or later.`
`2`	`2`
`3`	`3`	`# NOTE: EL8-based distros are known not to work on M1 chips: https://github.com/lima-vm/lima/issues/841`
`4`	`4`	`# EL9-based distros are known to work.`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This example requires Lima v0.11.1 or later.`
	`1`	`+# This template requires Lima v0.11.1 or later.`
`2`	`2`
`3`	`3`	`images:`
`4`	`4`	`- location: "https://repo.almalinux.org/almalinux/9.2/cloud/x86_64/images/AlmaLinux-9-GenericCloud-9.2-20230513.x86_64.qcow2"`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This example requires Lima v0.7.0 or later.`
	`1`	`+# This template requires Lima v0.7.0 or later.`
`2`	`2`	`# Using the Alpine 3.18 aarch64 image with vmType=vz requires macOS Ventura 13.3 or later.`
`3`	`3`
`4`	`4`	`images:`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Example to use Apptainer instead of containerd & nerdctl`
	`1`	`+# A template to use Apptainer instead of containerd & nerdctl`
`2`	`2`	`# $ limactl start ./apptainer-rootful.yaml`
`3`	`3`	`# $ limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Example to use BuildKit`
	`1`	`+# A template to use BuildKit`
`2`	`2`	`# $ limactl start ./buildkit.yaml`
`3`	`3`
`4`	`4`	# To run `buildkit` on the host (assumes buildctl is installed):