hyperkit
Overview
HyperKit is an open-source hypervisor for macOS hypervisor, optimized for lightweight virtual machines and container deployment.
Requirements
- macOS 10.11+
- HyperKit
HyperKit installation
- If Docker for Desktop is installed, you already have HyperKit
- Otherwise, if you have Brew Package Manager, run:
brew install hyperkit
- As a final alternative, you may Install HyperKit from GitHub
Usage
Start a cluster using the hyperkit driver:
minikube start --driver=hyperkit
To make hyperkit the default driver:
minikube config set driver hyperkit
Special features
minikube start supports additional hyperkit specific flags:
--hyperkit-vpnkit-sock
: Location of the VPNKit socket used for networking. If empty, disables Hyperkit VPNKitSock, if ‘auto’ uses Docker for Mac VPNKit connection, otherwise uses the specified VSock--hyperkit-vsock-ports
: List of guest VSock ports that should be exposed as sockets on the host--nfs-share
: Local folders to share with Guest via NFS mounts--nfs-shares-root
: Where to root the NFS Shares (default “/nfsshares”)--uuid
: Provide VM UUID to restore MAC address
Issues
Local DNS server conflict
If you are using dnsmasq
and minikube
fails, add listen-address=192.168.64.1
to dnsmasq.conf.
If you are running other DNS servers, shut them off or specify an alternative bind address.
Other
Troubleshooting
Run with logs
Run minikube start --alsologtostderr -v=7
to debug crashes
Upgrade HyperKit
New updates to macOS often require an updated hyperkit driver. To upgrade:
- If Docker for Desktop is installed, click on icon in your menu bar and select
Check for updates...
- If you have Brew Package Manager, run:
brew upgrade hyperkit
- As a final alternative, you install the latest HyperKit from GitHub
- To check your current version, run:
hyperkit -v
- If the version didn’t change after upgrading verify the correct HyperKit is in the path. run:
which hyperkit
Check driver version
Run docker-machine-driver-hyperkit version
to make sure the version matches minikube
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.