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:43:10 +00:00
### old hyperkit version
In start issues with hyperkit driver, upgrading hyperkit and ensuring the upgraded version is in the path, could solve the problem.
The latest version of hyperkit could be found [here ](https://github.com/moby/hyperkit/releases ).
You can check your current version by:
2020-04-23 00:26:17 +00:00
2020-04-23 00:34:57 +00:00
```
hyperkit -v
```
To upgrade try:
2020-04-23 00:26:17 +00:00
```
2020-04-23 00:43:10 +00:00
brew upgrade hyperkit
2020-04-23 00:26:17 +00:00
```
To verify your hyperkit version please run;
```
hyperkit -v
```
2019-08-08 21:06:33 +00:00
### Local DNS server conflict
2019-08-08 23:30:24 +00:00
If you are using `dnsmasq` and `minikube` fails, add `listen-address=192.168.64.1` to dnsmasq.conf.
2019-08-08 21:06:33 +00:00
2019-08-08 23:30:24 +00:00
If you are running other DNS servers, shut them off or specify an alternative bind address.
2019-08-08 21:06:33 +00:00
### Other
* [Full list of open 'hyperkit' driver issues ](https://github.com/kubernetes/minikube/labels/co%2Fhyperkit )
## Troubleshooting
2019-08-08 23:34:45 +00:00
* Run `docker-machine-driver-hyperkit version` to make sure the version matches minikube
2019-08-08 21:06:33 +00:00
* Run `minikube start --alsologtostderr -v=7` to debug crashes