From 57006e5b9ff08e5e68cc1e849ea1ce89fd996826 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Anders=20F=20Bj=C3=B6rklund?= <anders.f.bjorklund@gmail.com>
Date: Mon, 13 Nov 2023 18:56:33 +0100
Subject: [PATCH] docs: make it possible for lima to provide both
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Anders F Björklund <anders.f.bjorklund@gmail.com>
---
 website/docs/lima/customizing.md | 62 ++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 website/docs/lima/customizing.md

diff --git a/website/docs/lima/customizing.md b/website/docs/lima/customizing.md
new file mode 100644
index 00000000000..5de448ad217
--- /dev/null
+++ b/website/docs/lima/customizing.md
@@ -0,0 +1,62 @@
+---
+sidebar_position: 4
+title: Customizing Lima instance
+description: Customizing Lima
+keywords: [podman desktop, containers, kubernetes, lima]
+tags: [lima]
+---
+
+# Customizing the Lima instance for varying workloads
+
+You can customize Lima instance, using YAML and `yq`.
+
+#### Procedure
+
+- To create a new instance:
+
+  ```shell-session
+  $ limactl create <instance>
+  ```
+
+- To edit an existing instance:
+
+  ```shell-session
+  $ limactl edit <instance>
+  ```
+
+Some of the things you can edit:
+
+- Change the number of CPUs, the memory, and the disk size
+- Change the operating system (the Linux distribution)
+- Modify the cluster setup (the Kubernetes distribution)
+- Run **both** of container workloads and Kubernetes workloads
+
+### Containers
+
+You can install a container engine, in addition to the existing runtime.
+
+For instance you can install [Podman Engine](https://github.com/containers/podman),
+or you can install [Docker Engine](https://github.com/docker/docker).
+After that you can port forward the socket, to the host `Dir`.
+
+- `/var/run/docker.sock`
+- `/run/podman/podman.sock`
+
+```bash
+export DOCKER_HOST="unix://{{.Dir}}/sock/docker.sock"
+```
+
+### Kubernetes
+
+You can install Kubernetes, on top of the existing container engine.
+
+For instance you can use [CRI-O](https://github.com/cri-o/cri-o) for Podman,
+or [CRI-Dockerd](https://github.com/Mirantis/cri-dockerd) for Docker.
+After that you can copy the `kubeconfig.yaml` file, to the host `Dir`.
+
+- `/etc/rancher/k3s/k3s.yaml`
+- `/etc/kubernetes/admin.conf`
+
+```bash
+export KUBECONFIG="{{.Dir}}/copied-from-guest/kubeconfig.yaml"
+```