github/linuxkit
1
0
Fork 0
mirror of https://github.com/linuxkit/linuxkit.git synced 2025-07-27 12:38:11 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #1724 from rneugeba/mac-doc

Browse Source 
docs: Clarify hyperkit networking
This commit is contained in:
Rolf Neugebauer 2017-04-27 01:48:52 +01:00 committed by GitHub
commit 9b49be4bcf
1 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/mac.md
View File

@ -7,19 +7,31 @@ run` uses [HyperKit](https://github.com/moby/hyperkit) and
[VPNKit](https://github.com/moby/vpnkit) and the edge release ships [VPNKit](https://github.com/moby/vpnkit) and the edge release ships
with updated versions of both. with updated versions of both.
## Networking ## Networking
By default, `linuxkit run` creates a VM with a single network By default, `linuxkit run` creates a VM with a single network
interface which, logically, is attached to a L2 bridge, which also has interface which, logically, is attached to a L2 bridge. The bridge
the VM used by Docker for Mac attached to it. This means that the LinuxKit also has the VM used by Docker for Mac attached to it. This means that
VMs can be accessed from containers running on Docker for Mac. the LinuxKit VMs, created with `linuxkit run`, can be accessed from
containers running on Docker for Mac.
The LinuxKit VMs have IP addresses on the `192.168.65.0/24` subnet The LinuxKit VMs have IP addresses on the `192.168.65.0/24` subnet
assigned by a DHCP server part of VPNKit. `192.168.65.1` is reserved assigned by a DHCP server part of VPNKit. `192.168.65.1` is reserved
for VPNKit as the default gateway and `192.168.65.2` is used by the for VPNKit as the default gateway and `192.168.65.2` is used by the
Docker for Mac VM. Docker for Mac VM.
By default, LinuxKit VMs get incrementally increasing IP addresses, but you can assign a fixed IP address with `linuxkit run -ip`. It's best to choose an IP address from the DHCP address range above, but care must be taking to avoid clashes of IP address. By default, LinuxKit VMs get incrementally increasing IP addresses,
but you can assign a fixed IP address with `linuxkit run -ip`. It's
best to choose an IP address from the DHCP address range above, but
care must be taken to avoid clashes of IP address.
*NOTE:* The LinuxKit VMs can *not* be directly accessed by IP address
from the host. Enabling this would require use of the macOS `vmnet`
framework, which requires the VMs to run as `root`. We don't consider
this option palatable, and provide alternative options to access the
VMs over the network below.
### Accessing services ### Accessing services