site: Add krunkit driver documentation

Author: nirs

site/content/en/docs/drivers/_index.md

@@ -33,6 +33,7 @@ To do so, we use the [Docker Machine](https://github.com/docker/machine) library
 * [QEMU]({{<ref "qemu.md">}}) - VM
 * [Podman]({{<ref "podman.md">}}) - VM + Container (experimental)
 * [VFkit]({{<ref "vfkit.md">}}) - VM (preferred)
+* [Krunkit]({{<ref "krunkit.md">}}) - VM (experimental)
 * [SSH]({{<ref "ssh.md">}}) - remote ssh
 
 ## Windows

site/content/en/docs/drivers/krunkit.md

@@ -0,0 +1,92 @@
+---
+title: "krunkit"
+weight: 2
+aliases:
+    - /docs/reference/drivers/krunkit
+---
+
+## Overview
+
+[krunkit](https://github.com/containers/krunkit) is an open-source program for
+macOS virtualization, optimized for GPU accelerated virtual machines and AI
+workloads.
+
+## Requirements
+
+- Available only on Apple silicon
+- Requires macOS 10.15 or later
+- Requires minikube version 1.37.0 or later.
+- Requires [vmnet-helper](https://github.com/nirs/vmnet-helper).
+
+## Networking
+
+The krunkit driver requires [vmnet-helper](https://github.com/nirs/vmnet-helper), see
+installation instructions bellow.
+
+### Install vment-helper
+
+```shell
+tag="$(curl -fsSL https://api.github.com/repos/nirs/vmnet-helper/releases/latest | jq -r .tag_name)"
+machine="$(uname -m)"
+archive="vmnet-helper-$tag-$machine.tar.gz"
+curl -LOf "https://github.com/nirs/vmnet-helper/releases/download/$tag/$archive"
+sudo tar xvf "$archive" -C / opt/vmnet-helper
+rm "$archive"
+```
+
+The command downloads the latest release from github and installs it to
+`/opt/vmnet-helper`.
+
+**IMPORTANT**: The vmnet-helper executable and the directory where it is
+installed must be owned by root and may not be modifiable by
+unprivileged users.
+
+### Grant permission to run vmnet-helper
+
+The vment-helper process must run as root to create a vmnet interface.
+To allow users in the `staff` group to run the vmnet helper without a
+password, you can install the default sudoers rule:
+
+```shell
+sudo install -m 0640 /opt/vmnet-helper/share/doc/vmnet-helper/sudoers.d/vmnet-helper /etc/sudoers.d/
+```
+
+You can change the sudoers configuration to allow access to specific
+users or other groups.
+
+### Usage
+
+```shell
+minikube start --driver krunkit
+```
+
+## Issues
+
+### Other
+
+* [Full list of open 'krunkit' driver issues](https://github.com/kubernetes/minikube/labels/co%2Fkrunkit)
+
+## Troubleshooting
+
+### Run with logs
+
+Run `minikube start --driver vfkit --alsologtostderr -v=7` to debug crashes
+
+### Troubleshooting vmnet-helper
+
+Check for errors in vment-helper log:
+
+```shell
+$MINIKUBE_HOME/.minikube/machines/MACHINE-NAME/vmnet-helper.log
+```
+
+Check that the `vmnet-helper` process is running:
+
+```shell
+ps au | grep vmnet-helper | grep -v grep
+```
+
+If the helper is not running restart the minikube cluster.
+
+For help with vment-helper please use the
+[discussions](https://github.com/nirs/vmnet-helper/discussions).