diff --git a/README.md b/README.md index 205955f..641776e 100644 --- a/README.md +++ b/README.md @@ -7,18 +7,19 @@ The virtual machine contains docker, docker-compose and a NFS server to locally * Installation of [VirtualBox](https://www.virtualbox.org/wiki/Downloads) ## Installation and configuration -1. Add entry on /etc/hosts - need to use sudo to edit the file: `10.10.10.10 docker.local` -2. Access VirtualBox's network configuration for the Host-only Networks adapter vboxnet0 by accessing the menu VirtualBox -> Preferences -> Network -> Host-only Networks +1. Make sure no other VirtualBox networks adapter are on the subnet 10.10.10.x or you do not run any internal network on that subnet (the routing table be checked with `netstat -rn` and the routing for the subnet 10.10.10.x if exists can be found with `netstat -rn | grep 10.10.10`) +2. Add entry on /etc/hosts - need to use sudo to edit the file: `10.10.10.10 docker.local` +3. Access VirtualBox's network configuration for the Host-only Networks adapter `vboxnet0` by accessing the menu VirtualBox -> Preferences -> Network -> Host-only Networks 1. On Adapter tab: 1. IPv4 Address: 10.10.10.1 2. IPv4 Network Mask: 255.255.255.0 2. On DHPC Server tab: 1. Uncheck "Enable Server" -3. Download the [latest release](https://github.com/esimonetti/DebianDockerMac/releases/latest) of this git repository -4. Import the downloaded VirtualBox appliance by accessing the menu File -> Import Appliance and follow the prompts -5. Access the network configuration of the VirtualBox imported appliance by right clicking on the virtual machine -> Settings -> Network +4. Download the [latest release](https://github.com/esimonetti/DebianDockerMac/releases/latest) of this git repository +5. Import the downloaded VirtualBox appliance by accessing the menu File -> Import Appliance and follow the prompts +6. Access the network configuration of the VirtualBox imported appliance by right clicking on the virtual machine -> Settings -> Network 1. On the Adapter 1 tab: - 1. Make sure the Host-only Adapter Name is `vboxnet0` (or the same that has been setup with the settings on step 2) + 1. Make sure the Host-only Adapter Name is `vboxnet0` (or the matching adapter setup on step 3) 2. Click OK To boot the virtual machine double click on the virtual machine and wait few seconds for it to complete. @@ -42,3 +43,13 @@ To mount and access the virtual machine folder `/home/docker` from your Mac comp 2. Access the menu Go -> Connect to Server 3. On Server Address enter: `nfs://docker.local:/home/docker` 4. Click Connect + +## Network issues +If it is not possible to ssh or connect via NFS to the virtual machine, check the routing by running `netstat -rn | grep 10.10.10`. +The expected output should be similar to: +``` +10.10.10/24 link#15 UC 3 0 vboxnet +10.10.10.10 8:0:27:7e:51:3c UHLWI 0 71 vboxnet 1041 +10.10.10.255 ff:ff:ff:ff:ff:ff UHLWbI 0 18 vboxnet +``` +If the routing table does not look similar to the above, re-check the Host-only Networks adapter settings, and that the virtual machine correct adapter is selected. It might also be the case that VirtualBox requires an OS reboot before applying the routing correctly.