site/content/en/docs/drivers/krunkit.md
krunkit is an open-source program for macOS virtualization, optimized for GPU accelerated virtual machines and AI workloads.
To install krunkit run:
brew tap slp/krunkit
brew install krunkit
To use the krunkit driver you must install vmnet-helper, see installation instructions below.
curl -fsSL https://github.com/minikube-machine/vmnet-helper/releases/latest/download/install.sh | bash
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.
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:
The installation script will ask your permission to add to the sudoers but if you say no and prefer to do manually here is the command:
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.
minikube start --driver krunkit
Run minikube start --driver krunkit --alsologtostderr -v=7 to debug crashes
Check for errors in vment-helper log:
$MINIKUBE_HOME/.minikube/machines/MACHINE-NAME/vmnet-helper.log
Check that the vmnet-helper process is running:
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.