<commit_before>---
title: "hyperkit"
weight: 1
aliases:
    - /docs/reference/drivers/hyperkit
---

## Overview

[HyperKit](https://github.com/moby/hyperkit) is an open-source hypervisor for macOS hypervisor, optimized for lightweight virtual machines and container deployment.

{{% readfile file="/docs/drivers/includes/hyperkit_usage.inc" %}}

## 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.

### Hyperkit upgrade version
The version of correct Hyperkit not being in the path could cause issues in starting minikube.
Try upgrading Hyperkit and ensure the upgraded version is in the path.

The latest version of Hyperkit could be found [here](https://github.com/moby/hyperkit/releases).

You can check your current version by:

```
hyperkit -v
```

To upgrade try:
```
brew upgrade hyperkit
```

To verify your hyperkit version please run:
```
hyperkit -v
```

if the version didn't change to the latest version [here](https://github.com/moby/hyperkit/releases), you can check if there is an existing hyperkit in the path.
```
which hyperkit
```

alternatively you might want to install the latest version of docker-desktop.

### Other

* [Full list of open 'hyperkit' driver issues](https://github.com/kubernetes/minikube/labels/co%2Fhyperkit)

## Troubleshooting

* Run `docker-machine-driver-hyperkit version` to make sure the version matches minikube
* Run `minikube start --alsologtostderr -v=7` to debug crashes<commit_msg>address review comments<commit_after>---
title: "hyperkit"
weight: 1
aliases:
    - /docs/reference/drivers/hyperkit
---

## Overview

[HyperKit](https://github.com/moby/hyperkit) is an open-source hypervisor for macOS hypervisor, optimized for lightweight virtual machines and container deployment.

{{% readfile file="/docs/drivers/includes/hyperkit_usage.inc" %}}

## 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.

### Upgrading 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](https://github.com/moby/hyperkit/releases)

To check your current version:

`hyperkit -v`

* if the version didn't change after upgrading verify the correct hyperkit is in the path. run: `which hyperkit`


### Other

* [Full list of open 'hyperkit' driver issues](https://github.com/kubernetes/minikube/labels/co%2Fhyperkit)

## Troubleshooting

* Run `docker-machine-driver-hyperkit version` to make sure the version matches minikube
* Run `minikube start --alsologtostderr -v=7` to debug crashes
{'fraction_non_alphanumeric': 0.10578279266572638, 'fraction_numerical': 0.005641748942172073, 'mean_word_length': 4.576671035386632, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 7, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7046009', 'n_tokens_mistral': 1328, 'n_tokens_neox': 1228, 'n_words': 506}