linuxkit/examples/docker-for-mac.md
Avi Deitcher 154f943d01
switch from flags to cobra (#3884)
Signed-off-by: Avi Deitcher <avi@deitcher.net>

Signed-off-by: Avi Deitcher <avi@deitcher.net>
2022-12-29 10:31:57 +02:00

45 lines
1.3 KiB
Markdown

# Docker for Mac
[`docker-for-mac.yml`](./docker-for-mac.yml) contains an example use
of the open source components of Docker for Mac. The example has
support for controlling `dockerd` from the host via `vsudd` and port
forwarding with VPNKit. It requires HyperKit, VPNKit and a Docker
client on the host to run. The easiest way to install these at the
moment is to install a recent version of Docker for Mac.
To build it with the latest Docker CE:
```
$ linuxkit build -format iso-efi docker-for-mac.yml
```
To run the VM with a 4G disk:
```
linuxkit run hyperkit --networking=vpnkit --vsock-ports=2376 --disk size=4096M --data-file ./metadata.json --iso --uefi docker-for-mac-efi
```
Where the file `./metadata.json` should contain the desired docker daemon
configuration, for example:
```
{
"docker": {
"entries": {
"daemon.json": {
"content": "{\n \"debug\" : true,\n \"experimental\" : true\n}\n"
}
}
}
}
```
In another terminal you should now be able to access docker via the
socket `guest.00000948` in the state directory
(`docker-for-mac-efi-state/` by default):
```
$ docker -H unix://docker-for-mac-efi-state/guest.00000948 ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
```