2019-08-08 21:06:33 +00:00
---
2019-08-08 23:24:38 +00:00
title: "hyperkit"
2019-08-08 21:06:33 +00:00
weight: 1
2020-04-04 23:25:53 +00:00
aliases:
- /docs/reference/drivers/hyperkit
2019-08-08 21:06:33 +00:00
---
## Overview
[HyperKit ](https://github.com/moby/hyperkit ) is an open-source hypervisor for macOS hypervisor, optimized for lightweight virtual machines and container deployment.
2020-04-04 23:25:53 +00:00
{{% readfile file="/docs/drivers/includes/hyperkit_usage.inc" %}}
2019-08-08 21:06:33 +00:00
## Special features
2019-08-08 23:30:24 +00:00
minikube start supports additional hyperkit specific flags:
2019-08-08 21:06:33 +00:00
2019-12-31 16:43:14 +00:00
* **`--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
2019-08-10 00:46:01 +00:00
* **`--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")
2019-08-10 01:16:11 +00:00
* **`--uuid`**: Provide VM UUID to restore MAC address
2019-08-08 21:06:33 +00:00
## Issues
2020-04-23 00:50:13 +00:00
### 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.
2020-05-03 05:37:36 +00:00
### Other
2020-04-23 00:34:57 +00:00
2020-05-03 05:37:36 +00:00
* [Full list of open 'hyperkit' driver issues ](https://github.com/kubernetes/minikube/labels/co%2Fhyperkit )
2020-04-23 00:26:17 +00:00
2020-05-03 05:37:36 +00:00
## Troubleshooting
2020-04-23 00:26:17 +00:00
2020-04-23 00:57:45 +00:00
2020-05-03 05:37:36 +00:00
### Run with logs
Run `minikube start --alsologtostderr -v=7` to debug crashes
2019-08-08 21:06:33 +00:00
2020-05-03 05:37:36 +00:00
### Upgrade HyperKit
New updates to macOS often require an updated hyperkit driver. To upgrade:
2019-08-08 21:06:33 +00:00
2020-05-03 05:37:36 +00:00
* 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 ](https://github.com/moby/hyperkit/releases )
* 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`
2019-08-08 21:06:33 +00:00
2020-05-03 05:37:36 +00:00
### Check driver version
Run `docker-machine-driver-hyperkit version` to make sure the version matches minikube
