minikube/site/content/en/docs/drivers
Nir Soffer 56975bc752
Add krunkit driver supporting GPU acceleration on macOS (#20826)
* krunkit: Add krunkit driver

krunkit is a tool to launch configurable virtual machines using the
libkrun platform, optimized for GPU accelerated virtual machines and AI
workloads on Apple silicon.

It is mostly compatible with vfkit; the driver is a simplified copy of
the vfkit driver. Unlike vfkit, krunkit is available only on Apple
silicon.

Changes compared to vfkit driver:
- krunkit requires unix socket for networking, so we must use
  vment-helper.
- krunkit does not support HardStop, so we kill it using SIGKILL.
- We must enable vmnet offloading, required for krunkit.
- The code was simplified since vmnet-helper is always used
- Code was cleaned up to use .ResolveStorePath()
- Unused Upgrade() function was removed
- Types and functions that should not be public made private

We require krunkit 0.2.2, supporting --restul-uri=unix://.

* reason: Make vment-helper error driver agnostic

Previously it was used only for vfkit, so we suggested to fallback to
the `nat` network. This advice is not relevant to krunkit or to qemu
(which can also use vmnet-helper).

Change the error to recommend installing vment-helper. We need to think
how we can recommend other networks for vfkit and qemu. Another solution
is to create error for every driver+network combination but this seems
hard to manage.

* hack: Add krunkit integration test

This is the same way that we test vfkit. This test is not running in the
CI.

Issues:
- Need to install and configure vment-helper (requires root).

* site: Add krunkit driver documentation
2025-07-21 12:59:28 -07:00
..
includes treewide: Replace 'egrep' with 'grep -E' 2024-01-14 19:58:57 +01:00
_index.md Add krunkit driver supporting GPU acceleration on macOS (#20826) 2025-07-21 12:59:28 -07:00
docker.md site: add step manage-docker-as-a-non-root-user in the requirements of docker driver (#19925) 2024-11-07 09:51:48 -08:00
hyperkit.md Fix whitespace issues in the site content markdown 2020-12-05 10:08:32 +01:00
hyperv.md Fix link to GitHub open issues label for drivers 2023-04-05 15:44:08 -03:00
krunkit.md Add krunkit driver supporting GPU acceleration on macOS (#20826) 2025-07-21 12:59:28 -07:00
kvm2.md Fix typo: s/Virtulization/Virtualization/g 2024-07-19 14:15:53 +02:00
none.md remove sudo -E from none driver 2023-04-28 14:58:25 -07:00
parallels.md Fix link to GitHub open issues label for drivers 2023-04-05 15:44:08 -03:00
podman.md Fix link to GitHub open issues label for drivers 2023-04-05 15:44:08 -03:00
qemu.md Update qemu.md docs for homebrew/services decommission (#20685) 2025-05-15 11:13:29 -07:00
qemu2.md drop reference 2022-08-12 16:11:28 -07:00
ssh.md The github label wasn't renamed like the driver 2021-02-21 19:58:17 +01:00
vfkit.md docs: Update vment-helper installation (#21085) 2025-07-17 16:01:17 -07:00
virtualbox.md doc: VirtualBox driver NIC type alternative for performance enhancement 2024-03-23 08:28:21 +01:00
vmware.md docs: remove vmware_windows_usage.inc from vmware driver mac section 2022-02-06 11:20:20 -06:00