From 64b46a453242a1e71c6d88df36b9a42fc1688326 Mon Sep 17 00:00:00 2001 From: Alisha Rehman Date: Fri, 14 Nov 2025 19:25:44 +0500 Subject: [PATCH 1/2] Update docs: replace template:// with template: --- README.md | 4 +- docs/template_.code-search | 178 ++++++++++++++++++ template_.code-search | 178 ++++++++++++++++++ templates/README.md | 14 +- .../en/docs/config/environment-variables.md | 4 +- website/content/en/docs/config/multi-arch.md | 2 +- .../content/en/docs/config/vmtype/krunkit.md | 6 +- website/content/en/docs/config/vmtype/qemu.md | 4 +- website/content/en/docs/config/vmtype/vz.md | 4 +- website/content/en/docs/dev/drivers.md | 2 +- website/content/en/docs/dev/internals.md | 2 +- website/content/en/docs/examples/_index.md | 10 +- .../examples/containers/apptainer/_index.md | 4 +- .../containers/containerd/advanced/stargz.md | 2 +- .../docs/examples/containers/docker/_index.md | 4 +- .../examples/containers/kubernetes/_index.md | 8 +- .../docs/examples/containers/podman/_index.md | 4 +- website/content/en/docs/examples/gha.md | 6 +- website/content/en/docs/faq/colima.md | 8 +- website/content/en/docs/usage/_index.md | 2 +- 20 files changed, 401 insertions(+), 45 deletions(-) create mode 100644 docs/template_.code-search create mode 100644 template_.code-search diff --git a/README.md b/README.md index 7e529a01444..aad492d9b38 100644 --- a/README.md +++ b/README.md @@ -39,14 +39,14 @@ lima nerdctl run --rm hello-world To run containers with Docker: ```bash -limactl start template://docker +limactl start template:docker export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') docker run --rm hello-world ``` To run containers with Kubernetes: ```bash -limactl start template://k8s +limactl start template:k8s export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl apply -f ... ``` diff --git a/docs/template_.code-search b/docs/template_.code-search new file mode 100644 index 00000000000..0679d84aab6 --- /dev/null +++ b/docs/template_.code-search @@ -0,0 +1,178 @@ +# Query: template:// +# ContextLines: 1 + +48 results - 20 files + +README.md: + 41 ```bash + 42: limactl start template:*docker + 43 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 48 ```bash + 49: limactl start template:*k8s + 50 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + +hack\test-upgrade.sh: + 70 defer "show_lima_log;limactl delete -f \"${LIMA_INSTANCE}\"" + 71: limactl start --tty=false --name="${LIMA_INSTANCE}" template:*ubuntu-lts || ( + 72 show_lima_log + +pkg\limatmpl\abs_test.go: + 36 { + 37: "Legacy template:*base template", + 38: "template:*foo", + 39 `base: bar.yaml`, + +templates\README.md: + 1: Run `limactl start template:*fedora` to create a Lima instance named "fedora". + 2 + + 80 - ~`experimental/vz`~: Merged into the default template in Lima v1.0. See also . + 81: - ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template:*default`. + 82: - ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template:*default`. + 83: - ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template:*default` instead. See also . + 84: - ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template:*default` instead. See also . + 85: - ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template:*default` instead. See also . + 86: - ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template:*default` instead. See also . + 87 + +website\content\en\docs\config\environment-variables.md: + 41 + 42: - **Description**: Specifies the directories used to resolve `template:*` URLs. + 43 - **Default**: `$LIMA_HOME/_templates:/usr/local/share/lima/templates` + + 46 export LIMA_TEMPLATES_PATH="$HOME/.config/lima/templates:/usr/local/share/lima/templates" + 47: limactl create --name my-vm template:*my-distro + 48 ``` + +website\content\en\docs\config\multi-arch.md: + 44 base: + 45: - template:*_images/ubuntu + 46 ``` + +website\content\en\docs\config\vmtype\krunkit.md: + 84 ```bash + 85: limactl start --vm-type=krunkit template:*fedora + 86 limactl shell fedora + + 93 base: + 94: - template:*_images/fedora + 95: - template:*_default/mounts + 96 + +website\content\en\docs\config\vmtype\qemu.md: + 25 base: + 26: - template:*_images/ubuntu + 27: - template:*_default/mounts + 28 ``` + +website\content\en\docs\config\vmtype\vz.md: + 24 base: + 25: - template:*_images/ubuntu + 26: - template:*_default/mounts + 27 ``` + +website\content\en\docs\dev\drivers.md: + 91 ```bash + 92: limactl create myinstance --vm-type=mydriver template:*default + 93 ``` + +website\content\en\docs\dev\internals.md: + 111 + 112: The templates directory can store additional template files that can be referenced with the `template:*` schema. + 113 + +website\content\en\docs\examples\_index.md: + 38 ```bash + 39: limactl start template:*docker + 40 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 46 ```bash + 47: limactl start template:*podman + 48 export DOCKER_HOST=$(limactl list podman --format 'unix://{{.Dir}}/sock/podman.sock') + + 54 ```bash + 55: limactl start template:*k8s + 56 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 78 --network=vzNAT \ + 79: template:*fedora + 80 ``` + + 88 - `--network=vzNAT`: Make the VM reachable from the host by its IP address + 89: - `template:*fedora`: Use Fedora + +website\content\en\docs\examples\gha.md: + 45 set -eux + 46: limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 47 lima sudo dnf install -y httpd + + 52 set -eux + 53: limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 54 limactl shell another curl http://lima-default.internal + + 65 # --plain is set to disable file sharing, port forwarding, built-in containerd, etc. + 66: run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 67 + +website\content\en\docs\examples\containers\apptainer\_index.md: + 8 ```bash + 9: limactl start template:*apptainer + 10 limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine + + 14 ```bash + 15: limactl start template:*apptainer-rootful + 16 limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine + +website\content\en\docs\examples\containers\containerd\advanced\stargz.md: + 12 ```bash + 13: limactl start --name=default template:*ubuntu-24.04 + 14 ``` + +website\content\en\docs\examples\containers\docker\_index.md: + 8 ```bash + 9: limactl start template:*docker + 10 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 15 ```bash + 16: limactl start template:*docker-rootful + 17 export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock') + +website\content\en\docs\examples\containers\kubernetes\_index.md: + 10 ```bash + 11: limactl start template:*k8s + 12 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 23 ```bash + 24: limactl start template:*k3s + 25 export KUBECONFIG=$(limactl list k3s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 33 ```bash + 34: limactl start template:*k0s + 35 export KUBECONFIG=$(limactl list k0s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 43 ```bash + 44: limactl start template:*experimental/u7s + 45 export KUBECONFIG=$(limactl list u7s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + +website\content\en\docs\examples\containers\podman\_index.md: + 9 ```bash + 10: limactl start template:*podman + 11 limactl shell podman podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine + + 28 ```bash + 29: limactl start template:*podman-rootful + 30 limactl shell podman-rootful sudo podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine + +website\content\en\docs\faq\colima.md: + 16 | containerd | `limactl start` | `colima start --runtime=containerd` | + 17: | Docker | `limactl start template:*docker` | `colima start` | + 18: | Podman | `limactl start template:*podman` | - | + 19: | Kubernetes (k3s) | `limactl start template:*k3s` | `colima start --kubernetes` | + 20: | Kubernetes (kubeadm) | `limactl start template:*k8s` | - | + 21 + +website\content\en\docs\usage\_index.md: + 28 ```bash + 29: limactl create --name=default template:*docker + 30 limactl start default diff --git a/template_.code-search b/template_.code-search new file mode 100644 index 00000000000..0679d84aab6 --- /dev/null +++ b/template_.code-search @@ -0,0 +1,178 @@ +# Query: template:// +# ContextLines: 1 + +48 results - 20 files + +README.md: + 41 ```bash + 42: limactl start template:*docker + 43 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 48 ```bash + 49: limactl start template:*k8s + 50 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + +hack\test-upgrade.sh: + 70 defer "show_lima_log;limactl delete -f \"${LIMA_INSTANCE}\"" + 71: limactl start --tty=false --name="${LIMA_INSTANCE}" template:*ubuntu-lts || ( + 72 show_lima_log + +pkg\limatmpl\abs_test.go: + 36 { + 37: "Legacy template:*base template", + 38: "template:*foo", + 39 `base: bar.yaml`, + +templates\README.md: + 1: Run `limactl start template:*fedora` to create a Lima instance named "fedora". + 2 + + 80 - ~`experimental/vz`~: Merged into the default template in Lima v1.0. See also . + 81: - ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template:*default`. + 82: - ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template:*default`. + 83: - ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template:*default` instead. See also . + 84: - ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template:*default` instead. See also . + 85: - ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template:*default` instead. See also . + 86: - ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template:*default` instead. See also . + 87 + +website\content\en\docs\config\environment-variables.md: + 41 + 42: - **Description**: Specifies the directories used to resolve `template:*` URLs. + 43 - **Default**: `$LIMA_HOME/_templates:/usr/local/share/lima/templates` + + 46 export LIMA_TEMPLATES_PATH="$HOME/.config/lima/templates:/usr/local/share/lima/templates" + 47: limactl create --name my-vm template:*my-distro + 48 ``` + +website\content\en\docs\config\multi-arch.md: + 44 base: + 45: - template:*_images/ubuntu + 46 ``` + +website\content\en\docs\config\vmtype\krunkit.md: + 84 ```bash + 85: limactl start --vm-type=krunkit template:*fedora + 86 limactl shell fedora + + 93 base: + 94: - template:*_images/fedora + 95: - template:*_default/mounts + 96 + +website\content\en\docs\config\vmtype\qemu.md: + 25 base: + 26: - template:*_images/ubuntu + 27: - template:*_default/mounts + 28 ``` + +website\content\en\docs\config\vmtype\vz.md: + 24 base: + 25: - template:*_images/ubuntu + 26: - template:*_default/mounts + 27 ``` + +website\content\en\docs\dev\drivers.md: + 91 ```bash + 92: limactl create myinstance --vm-type=mydriver template:*default + 93 ``` + +website\content\en\docs\dev\internals.md: + 111 + 112: The templates directory can store additional template files that can be referenced with the `template:*` schema. + 113 + +website\content\en\docs\examples\_index.md: + 38 ```bash + 39: limactl start template:*docker + 40 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 46 ```bash + 47: limactl start template:*podman + 48 export DOCKER_HOST=$(limactl list podman --format 'unix://{{.Dir}}/sock/podman.sock') + + 54 ```bash + 55: limactl start template:*k8s + 56 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 78 --network=vzNAT \ + 79: template:*fedora + 80 ``` + + 88 - `--network=vzNAT`: Make the VM reachable from the host by its IP address + 89: - `template:*fedora`: Use Fedora + +website\content\en\docs\examples\gha.md: + 45 set -eux + 46: limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 47 lima sudo dnf install -y httpd + + 52 set -eux + 53: limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 54 limactl shell another curl http://lima-default.internal + + 65 # --plain is set to disable file sharing, port forwarding, built-in containerd, etc. + 66: run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora + 67 + +website\content\en\docs\examples\containers\apptainer\_index.md: + 8 ```bash + 9: limactl start template:*apptainer + 10 limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine + + 14 ```bash + 15: limactl start template:*apptainer-rootful + 16 limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine + +website\content\en\docs\examples\containers\containerd\advanced\stargz.md: + 12 ```bash + 13: limactl start --name=default template:*ubuntu-24.04 + 14 ``` + +website\content\en\docs\examples\containers\docker\_index.md: + 8 ```bash + 9: limactl start template:*docker + 10 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') + + 15 ```bash + 16: limactl start template:*docker-rootful + 17 export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock') + +website\content\en\docs\examples\containers\kubernetes\_index.md: + 10 ```bash + 11: limactl start template:*k8s + 12 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 23 ```bash + 24: limactl start template:*k3s + 25 export KUBECONFIG=$(limactl list k3s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 33 ```bash + 34: limactl start template:*k0s + 35 export KUBECONFIG=$(limactl list k0s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + + 43 ```bash + 44: limactl start template:*experimental/u7s + 45 export KUBECONFIG=$(limactl list u7s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') + +website\content\en\docs\examples\containers\podman\_index.md: + 9 ```bash + 10: limactl start template:*podman + 11 limactl shell podman podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine + + 28 ```bash + 29: limactl start template:*podman-rootful + 30 limactl shell podman-rootful sudo podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine + +website\content\en\docs\faq\colima.md: + 16 | containerd | `limactl start` | `colima start --runtime=containerd` | + 17: | Docker | `limactl start template:*docker` | `colima start` | + 18: | Podman | `limactl start template:*podman` | - | + 19: | Kubernetes (k3s) | `limactl start template:*k3s` | `colima start --kubernetes` | + 20: | Kubernetes (kubeadm) | `limactl start template:*k8s` | - | + 21 + +website\content\en\docs\usage\_index.md: + 28 ```bash + 29: limactl create --name=default template:*docker + 30 limactl start default diff --git a/templates/README.md b/templates/README.md index a4639966ee6..505df784780 100644 --- a/templates/README.md +++ b/templates/README.md @@ -1,4 +1,4 @@ -Run `limactl start template://fedora` to create a Lima instance named "fedora". +Run `limactl start template:fedora` to create a Lima instance named "fedora". To open a shell, run `limactl shell fedora bash` or `LIMA_INSTANCE=fedora lima bash`. @@ -78,12 +78,12 @@ Lost+found: - ~`centos-stream-8`~: Remove in Lima v0.23.0, as CentOS Stream 8 reached [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/). - ~`deprecated/centos-7`~: Remove in Lima v0.23.0, as CentOS 7 reached [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/). - ~`experimental/vz`~: Merged into the default template in Lima v1.0. See also . -- ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template://default`. -- ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template://default`. -- ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template://default` instead. See also . -- ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template://default` instead. See also . -- ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template://default` instead. See also . -- ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template://default` instead. See also . +- ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template:default`. +- ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template:default`. +- ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template:default` instead. See also . +- ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template:default` instead. See also . +- ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template:default` instead. See also . +- ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template:default` instead. See also . ## Tier diff --git a/website/content/en/docs/config/environment-variables.md b/website/content/en/docs/config/environment-variables.md index 7881d5eddf4..d4e9504a347 100644 --- a/website/content/en/docs/config/environment-variables.md +++ b/website/content/en/docs/config/environment-variables.md @@ -39,12 +39,12 @@ This page documents the environment variables used in Lima. ### `LIMA_TEMPLATES_PATH` -- **Description**: Specifies the directories used to resolve `template://` URLs. +- **Description**: Specifies the directories used to resolve `template:` URLs. - **Default**: `$LIMA_HOME/_templates:/usr/local/share/lima/templates` - **Usage**: ```sh export LIMA_TEMPLATES_PATH="$HOME/.config/lima/templates:/usr/local/share/lima/templates" - limactl create --name my-vm template://my-distro + limactl create --name my-vm template:my-distro ``` ### `LIMA_WORKDIR` diff --git a/website/content/en/docs/config/multi-arch.md b/website/content/en/docs/config/multi-arch.md index e7836aea996..bf6e6a24ad8 100644 --- a/website/content/en/docs/config/multi-arch.md +++ b/website/content/en/docs/config/multi-arch.md @@ -42,7 +42,7 @@ arch: "x86_64" plain: true base: -- template://_images/ubuntu +- template:_images/ubuntu ``` {{% /tab %}} {{< /tabpane >}} diff --git a/website/content/en/docs/config/vmtype/krunkit.md b/website/content/en/docs/config/vmtype/krunkit.md index 39fcc328536..c0066efa2f6 100644 --- a/website/content/en/docs/config/vmtype/krunkit.md +++ b/website/content/en/docs/config/vmtype/krunkit.md @@ -82,7 +82,7 @@ This path builds and installs dependencies (which can take some time. For faster {{< tabpane text=true >}} {{% tab header="CLI" %}} ```bash -limactl start --vm-type=krunkit template://fedora +limactl start --vm-type=krunkit template:fedora limactl shell fedora ``` {{% /tab %}} @@ -91,8 +91,8 @@ limactl shell fedora vmType: krunkit base: -- template://_images/fedora -- template://_default/mounts +- template:_images/fedora +- template:_default/mounts mountType: virtiofs ``` diff --git a/website/content/en/docs/config/vmtype/qemu.md b/website/content/en/docs/config/vmtype/qemu.md index 543c0adedbd..91f0d222f64 100644 --- a/website/content/en/docs/config/vmtype/qemu.md +++ b/website/content/en/docs/config/vmtype/qemu.md @@ -23,8 +23,8 @@ limactl start --vm-type=qemu vmType: "qemu" base: -- template://_images/ubuntu -- template://_default/mounts +- template:_images/ubuntu +- template:_default/mounts ``` {{% /tab %}} {{< /tabpane >}} \ No newline at end of file diff --git a/website/content/en/docs/config/vmtype/vz.md b/website/content/en/docs/config/vmtype/vz.md index bcd0cb28f2f..2eba6550844 100644 --- a/website/content/en/docs/config/vmtype/vz.md +++ b/website/content/en/docs/config/vmtype/vz.md @@ -22,8 +22,8 @@ limactl start --vm-type=vz vmType: "vz" base: -- template://_images/ubuntu -- template://_default/mounts +- template:_images/ubuntu +- template:_default/mounts ``` {{% /tab %}} {{< /tabpane >}} diff --git a/website/content/en/docs/dev/drivers.md b/website/content/en/docs/dev/drivers.md index f1830e9dcb0..07018978b7c 100644 --- a/website/content/en/docs/dev/drivers.md +++ b/website/content/en/docs/dev/drivers.md @@ -89,7 +89,7 @@ func main() { 4. **Use the driver**: Explicitly specify the driver when creating instances: ```bash -limactl create myinstance --vm-type=mydriver template://default +limactl create myinstance --vm-type=mydriver template:default ``` ## Examples diff --git a/website/content/en/docs/dev/internals.md b/website/content/en/docs/dev/internals.md index 559f9ed75bd..de98d60671b 100644 --- a/website/content/en/docs/dev/internals.md +++ b/website/content/en/docs/dev/internals.md @@ -109,7 +109,7 @@ When using `vmType: vz` (Virtualization.framework), on boot, any qcow2 (default) ## Templates directory (`${LIMA_HOME}/_templates`) -The templates directory can store additional template files that can be referenced with the `template://` schema. +The templates directory can store additional template files that can be referenced with the `template:` schema. If the template directory exists (and `$LIMA_TEMPLATES_PATH` is not set), then this directory will be searched before the `/usr/local/share/lima/templates` default directory that contains all the templates bundled with Lima itself. diff --git a/website/content/en/docs/examples/_index.md b/website/content/en/docs/examples/_index.md index 094bbc481e1..45e2c68479b 100644 --- a/website/content/en/docs/examples/_index.md +++ b/website/content/en/docs/examples/_index.md @@ -36,7 +36,7 @@ nerdctl.lima run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine {{% tab header="Docker" %}} ```bash -limactl start template://docker +limactl start template:docker export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine ``` @@ -44,7 +44,7 @@ docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine {{% tab header="Podman" %}} ```bash -limactl start template://podman +limactl start template:podman export DOCKER_HOST=$(limactl list podman --format 'unix://{{.Dir}}/sock/podman.sock') docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine ``` @@ -52,7 +52,7 @@ docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine {{% tab header="Kubernetes" %}} ```bash -limactl start template://k8s +limactl start template:k8s export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl create deployment nginx --image nginx:alpine kubectl create service nodeport nginx --node-port=31080 --tcp=80:80 @@ -76,7 +76,7 @@ limactl start \ --rosetta \ --mount-writable \ --network=vzNAT \ - template://fedora + template:fedora ``` - `--name=default`: Set the instance name to "default" @@ -86,4 +86,4 @@ limactl start \ - `--rosetta`: Allow running Intel (AMD) binaries on ARM - `--mount-writable`: Make the home mount (`/Users/`) writable - `--network=vzNAT`: Make the VM reachable from the host by its IP address -- `template://fedora`: Use Fedora +- `template:fedora`: Use Fedora diff --git a/website/content/en/docs/examples/containers/apptainer/_index.md b/website/content/en/docs/examples/containers/apptainer/_index.md index 4b4d9142419..a4e4f49f4e8 100644 --- a/website/content/en/docs/examples/containers/apptainer/_index.md +++ b/website/content/en/docs/examples/containers/apptainer/_index.md @@ -6,13 +6,13 @@ weight: 90 {{< tabpane text=true >}} {{% tab header="Rootless" %}} ```bash -limactl start template://apptainer +limactl start template:apptainer limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine ``` {{% /tab %}} {{% tab header="Rootful" %}} ```bash -limactl start template://apptainer-rootful +limactl start template:apptainer-rootful limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine ``` {{% /tab %}} diff --git a/website/content/en/docs/examples/containers/containerd/advanced/stargz.md b/website/content/en/docs/examples/containers/containerd/advanced/stargz.md index 81de7e61f61..18995dd1bc4 100644 --- a/website/content/en/docs/examples/containers/containerd/advanced/stargz.md +++ b/website/content/en/docs/examples/containers/containerd/advanced/stargz.md @@ -10,7 +10,7 @@ that reduces start-up latency using lazy-pulling technique. The support for eStargz is available by default for `ubuntu-24.04` instances: ```bash -limactl start --name=default template://ubuntu-24.04 +limactl start --name=default template:ubuntu-24.04 ``` The latest Ubuntu will be supported too in [a future release](https://github.com/containerd/stargz-snapshotter/issues/2144). diff --git a/website/content/en/docs/examples/containers/docker/_index.md b/website/content/en/docs/examples/containers/docker/_index.md index eea3ff030ea..3ea3a5779fb 100644 --- a/website/content/en/docs/examples/containers/docker/_index.md +++ b/website/content/en/docs/examples/containers/docker/_index.md @@ -6,14 +6,14 @@ weight: 2 {{< tabpane text=true >}} {{% tab header="Rootless" %}} ```bash -limactl start template://docker +limactl start template:docker export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine ``` {{% /tab %}} {{% tab header="Rootful" %}} ```bash -limactl start template://docker-rootful +limactl start template:docker-rootful export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock') docker run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine ``` diff --git a/website/content/en/docs/examples/containers/kubernetes/_index.md b/website/content/en/docs/examples/containers/kubernetes/_index.md index 67789973563..6ec4432b13b 100644 --- a/website/content/en/docs/examples/containers/kubernetes/_index.md +++ b/website/content/en/docs/examples/containers/kubernetes/_index.md @@ -8,7 +8,7 @@ weight: 4 {{< tabpane text=true >}} {{% tab header="kubeadm" %}} ```bash -limactl start template://k8s +limactl start template:k8s export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl create deployment nginx --image nginx:alpine kubectl create service nodeport nginx --node-port=31080 --tcp=80:80 @@ -21,7 +21,7 @@ See also . {{% /tab %}} {{% tab header="k3s" %}} ```bash -limactl start template://k3s +limactl start template:k3s export KUBECONFIG=$(limactl list k3s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl create deployment nginx --image nginx:alpine kubectl create service nodeport nginx --node-port=31080 --tcp=80:80 @@ -31,7 +31,7 @@ See also . {{% /tab %}} {{% tab header="k0s" %}} ```bash -limactl start template://k0s +limactl start template:k0s export KUBECONFIG=$(limactl list k0s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl create deployment nginx --image nginx:alpine kubectl create service nodeport nginx --node-port=31080 --tcp=80:80 @@ -41,7 +41,7 @@ See also . {{% /tab %}} {{% tab header="Usernetes" %}} ```bash -limactl start template://experimental/u7s +limactl start template:experimental/u7s export KUBECONFIG=$(limactl list u7s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') kubectl create deployment nginx --image nginx:alpine # NodePorts are not available by default in the case of Usernetes diff --git a/website/content/en/docs/examples/containers/podman/_index.md b/website/content/en/docs/examples/containers/podman/_index.md index 1e721166a5c..d1999d98336 100644 --- a/website/content/en/docs/examples/containers/podman/_index.md +++ b/website/content/en/docs/examples/containers/podman/_index.md @@ -7,7 +7,7 @@ weight: 3 {{% tab header="Rootless" %}} To use `podman` command in the VM: ```bash -limactl start template://podman +limactl start template:podman limactl shell podman podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine ``` @@ -26,7 +26,7 @@ docker run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine {{% tab header="Rootful" %}} To use `podman` command in the VM: ```bash -limactl start template://podman-rootful +limactl start template:podman-rootful limactl shell podman-rootful sudo podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine ``` diff --git a/website/content/en/docs/examples/gha.md b/website/content/en/docs/examples/gha.md index 4c0f9090ed8..a1965e81dc9 100644 --- a/website/content/en/docs/examples/gha.md +++ b/website/content/en/docs/examples/gha.md @@ -43,14 +43,14 @@ jobs: - name: "Start an instance of Fedora" run: | set -eux - limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template://fedora + limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:fedora lima sudo dnf install -y httpd lima sudo systemctl enable --now httpd - name: "Start another instance of Fedora" run: | set -eux - limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template://fedora + limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template:fedora limactl shell another curl http://lima-default.internal ``` @@ -63,7 +63,7 @@ The `--plain` mode is useful when you want the VM instance to be as close as pos ```yaml - name: "Start Fedora" # --plain is set to disable file sharing, port forwarding, built-in containerd, etc. - run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template://fedora + run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:fedora - name: "Initialize Fedora" # plain old rsync and ssh are used for the initialization of the guest, diff --git a/website/content/en/docs/faq/colima.md b/website/content/en/docs/faq/colima.md index 4f872db863d..6930fb3a9f4 100644 --- a/website/content/en/docs/faq/colima.md +++ b/website/content/en/docs/faq/colima.md @@ -14,10 +14,10 @@ while Lima launches containerd by default. | Container | Lima | Colima | |----------------------|-----------------------------------|-------------------------------------| | containerd | `limactl start` | `colima start --runtime=containerd` | -| Docker | `limactl start template://docker` | `colima start` | -| Podman | `limactl start template://podman` | - | -| Kubernetes (k3s) | `limactl start template://k3s` | `colima start --kubernetes` | -| Kubernetes (kubeadm) | `limactl start template://k8s` | - | +| Docker | `limactl start template:docker` | `colima start` | +| Podman | `limactl start template:podman` | - | +| Kubernetes (k3s) | `limactl start template:k3s` | `colima start --kubernetes` | +| Kubernetes (kubeadm) | `limactl start template:k8s` | - | The `colima` CLI is similar to the `limactl` CLI, but there are subtle differences: diff --git a/website/content/en/docs/usage/_index.md b/website/content/en/docs/usage/_index.md index d6ec151112a..25d7c65276c 100644 --- a/website/content/en/docs/usage/_index.md +++ b/website/content/en/docs/usage/_index.md @@ -26,7 +26,7 @@ For automation, `--tty=false` flag can be used for disabling the interactive us ### Customization To create an instance "default" from a template "docker": ```bash -limactl create --name=default template://docker +limactl create --name=default template:docker limactl start default ``` From 0193d43e16b7be210bf644f5803d70ae6079422d Mon Sep 17 00:00:00 2001 From: Alisha Rehman Date: Fri, 14 Nov 2025 19:53:48 +0500 Subject: [PATCH 2/2] fix: update docs to replace template:// with template: per v2.0 spec --- docs/template_.code-search | 178 ------------------------------------- template_.code-search | 178 ------------------------------------- 2 files changed, 356 deletions(-) delete mode 100644 docs/template_.code-search delete mode 100644 template_.code-search diff --git a/docs/template_.code-search b/docs/template_.code-search deleted file mode 100644 index 0679d84aab6..00000000000 --- a/docs/template_.code-search +++ /dev/null @@ -1,178 +0,0 @@ -# Query: template:// -# ContextLines: 1 - -48 results - 20 files - -README.md: - 41 ```bash - 42: limactl start template:*docker - 43 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 48 ```bash - 49: limactl start template:*k8s - 50 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - -hack\test-upgrade.sh: - 70 defer "show_lima_log;limactl delete -f \"${LIMA_INSTANCE}\"" - 71: limactl start --tty=false --name="${LIMA_INSTANCE}" template:*ubuntu-lts || ( - 72 show_lima_log - -pkg\limatmpl\abs_test.go: - 36 { - 37: "Legacy template:*base template", - 38: "template:*foo", - 39 `base: bar.yaml`, - -templates\README.md: - 1: Run `limactl start template:*fedora` to create a Lima instance named "fedora". - 2 - - 80 - ~`experimental/vz`~: Merged into the default template in Lima v1.0. See also . - 81: - ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template:*default`. - 82: - ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template:*default`. - 83: - ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template:*default` instead. See also . - 84: - ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template:*default` instead. See also . - 85: - ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template:*default` instead. See also . - 86: - ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template:*default` instead. See also . - 87 - -website\content\en\docs\config\environment-variables.md: - 41 - 42: - **Description**: Specifies the directories used to resolve `template:*` URLs. - 43 - **Default**: `$LIMA_HOME/_templates:/usr/local/share/lima/templates` - - 46 export LIMA_TEMPLATES_PATH="$HOME/.config/lima/templates:/usr/local/share/lima/templates" - 47: limactl create --name my-vm template:*my-distro - 48 ``` - -website\content\en\docs\config\multi-arch.md: - 44 base: - 45: - template:*_images/ubuntu - 46 ``` - -website\content\en\docs\config\vmtype\krunkit.md: - 84 ```bash - 85: limactl start --vm-type=krunkit template:*fedora - 86 limactl shell fedora - - 93 base: - 94: - template:*_images/fedora - 95: - template:*_default/mounts - 96 - -website\content\en\docs\config\vmtype\qemu.md: - 25 base: - 26: - template:*_images/ubuntu - 27: - template:*_default/mounts - 28 ``` - -website\content\en\docs\config\vmtype\vz.md: - 24 base: - 25: - template:*_images/ubuntu - 26: - template:*_default/mounts - 27 ``` - -website\content\en\docs\dev\drivers.md: - 91 ```bash - 92: limactl create myinstance --vm-type=mydriver template:*default - 93 ``` - -website\content\en\docs\dev\internals.md: - 111 - 112: The templates directory can store additional template files that can be referenced with the `template:*` schema. - 113 - -website\content\en\docs\examples\_index.md: - 38 ```bash - 39: limactl start template:*docker - 40 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 46 ```bash - 47: limactl start template:*podman - 48 export DOCKER_HOST=$(limactl list podman --format 'unix://{{.Dir}}/sock/podman.sock') - - 54 ```bash - 55: limactl start template:*k8s - 56 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 78 --network=vzNAT \ - 79: template:*fedora - 80 ``` - - 88 - `--network=vzNAT`: Make the VM reachable from the host by its IP address - 89: - `template:*fedora`: Use Fedora - -website\content\en\docs\examples\gha.md: - 45 set -eux - 46: limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 47 lima sudo dnf install -y httpd - - 52 set -eux - 53: limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 54 limactl shell another curl http://lima-default.internal - - 65 # --plain is set to disable file sharing, port forwarding, built-in containerd, etc. - 66: run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 67 - -website\content\en\docs\examples\containers\apptainer\_index.md: - 8 ```bash - 9: limactl start template:*apptainer - 10 limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine - - 14 ```bash - 15: limactl start template:*apptainer-rootful - 16 limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine - -website\content\en\docs\examples\containers\containerd\advanced\stargz.md: - 12 ```bash - 13: limactl start --name=default template:*ubuntu-24.04 - 14 ``` - -website\content\en\docs\examples\containers\docker\_index.md: - 8 ```bash - 9: limactl start template:*docker - 10 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 15 ```bash - 16: limactl start template:*docker-rootful - 17 export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock') - -website\content\en\docs\examples\containers\kubernetes\_index.md: - 10 ```bash - 11: limactl start template:*k8s - 12 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 23 ```bash - 24: limactl start template:*k3s - 25 export KUBECONFIG=$(limactl list k3s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 33 ```bash - 34: limactl start template:*k0s - 35 export KUBECONFIG=$(limactl list k0s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 43 ```bash - 44: limactl start template:*experimental/u7s - 45 export KUBECONFIG=$(limactl list u7s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - -website\content\en\docs\examples\containers\podman\_index.md: - 9 ```bash - 10: limactl start template:*podman - 11 limactl shell podman podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine - - 28 ```bash - 29: limactl start template:*podman-rootful - 30 limactl shell podman-rootful sudo podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine - -website\content\en\docs\faq\colima.md: - 16 | containerd | `limactl start` | `colima start --runtime=containerd` | - 17: | Docker | `limactl start template:*docker` | `colima start` | - 18: | Podman | `limactl start template:*podman` | - | - 19: | Kubernetes (k3s) | `limactl start template:*k3s` | `colima start --kubernetes` | - 20: | Kubernetes (kubeadm) | `limactl start template:*k8s` | - | - 21 - -website\content\en\docs\usage\_index.md: - 28 ```bash - 29: limactl create --name=default template:*docker - 30 limactl start default diff --git a/template_.code-search b/template_.code-search deleted file mode 100644 index 0679d84aab6..00000000000 --- a/template_.code-search +++ /dev/null @@ -1,178 +0,0 @@ -# Query: template:// -# ContextLines: 1 - -48 results - 20 files - -README.md: - 41 ```bash - 42: limactl start template:*docker - 43 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 48 ```bash - 49: limactl start template:*k8s - 50 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - -hack\test-upgrade.sh: - 70 defer "show_lima_log;limactl delete -f \"${LIMA_INSTANCE}\"" - 71: limactl start --tty=false --name="${LIMA_INSTANCE}" template:*ubuntu-lts || ( - 72 show_lima_log - -pkg\limatmpl\abs_test.go: - 36 { - 37: "Legacy template:*base template", - 38: "template:*foo", - 39 `base: bar.yaml`, - -templates\README.md: - 1: Run `limactl start template:*fedora` to create a Lima instance named "fedora". - 2 - - 80 - ~`experimental/vz`~: Merged into the default template in Lima v1.0. See also . - 81: - ~`experimental/armv7l`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=armv7l template:*default`. - 82: - ~`experimental/riscv64`~: Merged into the `default` template in Lima v1.0. Use `limactl create --arch=riscv64 template:*default`. - 83: - ~`vmnet`~: Removed in Lima v1.0. Use `limactl create --network=lima:shared template:*default` instead. See also . - 84: - ~`experimental/net-user-v2`~: Removed in Lima v1.0. Use `limactl create --network=lima:user-v2 template:*default` instead. See also . - 85: - ~`experimental/9p`~: Removed in Lima v1.0. Use `limactl create --vm-type=qemu --mount-type=9p template:*default` instead. See also . - 86: - ~`experimental/virtiofs-linux`~: Removed in Lima v1.0. Use `limactl create --mount-type=virtiofs-linux template:*default` instead. See also . - 87 - -website\content\en\docs\config\environment-variables.md: - 41 - 42: - **Description**: Specifies the directories used to resolve `template:*` URLs. - 43 - **Default**: `$LIMA_HOME/_templates:/usr/local/share/lima/templates` - - 46 export LIMA_TEMPLATES_PATH="$HOME/.config/lima/templates:/usr/local/share/lima/templates" - 47: limactl create --name my-vm template:*my-distro - 48 ``` - -website\content\en\docs\config\multi-arch.md: - 44 base: - 45: - template:*_images/ubuntu - 46 ``` - -website\content\en\docs\config\vmtype\krunkit.md: - 84 ```bash - 85: limactl start --vm-type=krunkit template:*fedora - 86 limactl shell fedora - - 93 base: - 94: - template:*_images/fedora - 95: - template:*_default/mounts - 96 - -website\content\en\docs\config\vmtype\qemu.md: - 25 base: - 26: - template:*_images/ubuntu - 27: - template:*_default/mounts - 28 ``` - -website\content\en\docs\config\vmtype\vz.md: - 24 base: - 25: - template:*_images/ubuntu - 26: - template:*_default/mounts - 27 ``` - -website\content\en\docs\dev\drivers.md: - 91 ```bash - 92: limactl create myinstance --vm-type=mydriver template:*default - 93 ``` - -website\content\en\docs\dev\internals.md: - 111 - 112: The templates directory can store additional template files that can be referenced with the `template:*` schema. - 113 - -website\content\en\docs\examples\_index.md: - 38 ```bash - 39: limactl start template:*docker - 40 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 46 ```bash - 47: limactl start template:*podman - 48 export DOCKER_HOST=$(limactl list podman --format 'unix://{{.Dir}}/sock/podman.sock') - - 54 ```bash - 55: limactl start template:*k8s - 56 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 78 --network=vzNAT \ - 79: template:*fedora - 80 ``` - - 88 - `--network=vzNAT`: Make the VM reachable from the host by its IP address - 89: - `template:*fedora`: Use Fedora - -website\content\en\docs\examples\gha.md: - 45 set -eux - 46: limactl start --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 47 lima sudo dnf install -y httpd - - 52 set -eux - 53: limactl start --name=another --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 54 limactl shell another curl http://lima-default.internal - - 65 # --plain is set to disable file sharing, port forwarding, built-in containerd, etc. - 66: run: limactl start --plain --name=default --cpus=1 --memory=1 --network=lima:user-v2 template:*fedora - 67 - -website\content\en\docs\examples\containers\apptainer\_index.md: - 8 ```bash - 9: limactl start template:*apptainer - 10 limactl shell apptainer apptainer run -u -B $HOME:$HOME docker://alpine - - 14 ```bash - 15: limactl start template:*apptainer-rootful - 16 limactl shell apptainer-rootful apptainer run -u -B $HOME:$HOME docker://alpine - -website\content\en\docs\examples\containers\containerd\advanced\stargz.md: - 12 ```bash - 13: limactl start --name=default template:*ubuntu-24.04 - 14 ``` - -website\content\en\docs\examples\containers\docker\_index.md: - 8 ```bash - 9: limactl start template:*docker - 10 export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock') - - 15 ```bash - 16: limactl start template:*docker-rootful - 17 export DOCKER_HOST=$(limactl list docker-rootful --format 'unix://{{.Dir}}/sock/docker.sock') - -website\content\en\docs\examples\containers\kubernetes\_index.md: - 10 ```bash - 11: limactl start template:*k8s - 12 export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 23 ```bash - 24: limactl start template:*k3s - 25 export KUBECONFIG=$(limactl list k3s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 33 ```bash - 34: limactl start template:*k0s - 35 export KUBECONFIG=$(limactl list k0s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - - 43 ```bash - 44: limactl start template:*experimental/u7s - 45 export KUBECONFIG=$(limactl list u7s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml') - -website\content\en\docs\examples\containers\podman\_index.md: - 9 ```bash - 10: limactl start template:*podman - 11 limactl shell podman podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine - - 28 ```bash - 29: limactl start template:*podman-rootful - 30 limactl shell podman-rootful sudo podman run -d --name nginx -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine - -website\content\en\docs\faq\colima.md: - 16 | containerd | `limactl start` | `colima start --runtime=containerd` | - 17: | Docker | `limactl start template:*docker` | `colima start` | - 18: | Podman | `limactl start template:*podman` | - | - 19: | Kubernetes (k3s) | `limactl start template:*k3s` | `colima start --kubernetes` | - 20: | Kubernetes (kubeadm) | `limactl start template:*k8s` | - | - 21 - -website\content\en\docs\usage\_index.md: - 28 ```bash - 29: limactl create --name=default template:*docker - 30 limactl start default