This is a toolbox to run DockerRoot on xhyve hypervisor easily.
For VirtualBox or QEMU, see https://github.com/ailispaw/docker-root-packer.
- DockerRoot
- Disable TLS
- Expose the official IANA registered Docker port 2375
- Support NFS synced folder: $HOME is NFS-mounted on the DockerRoot VM.
- xhyve
- Mac OS X Yosemite 10.10.3 or later
- A 2010 or later Mac (i.e. a CPU that supports EPT)
- Kernel Panic will occur on booting, if VirtualBox (< v5.0) has run before.
- Pay attention to exposing the port 2375 without TLS, as you see the features.
$ git clone https://github.com/mist64/xhyve
$ cd xhyve
$ make
$ cp build/xhyve /usr/local/bin/ # You may require sudo
or
$ brew install xhyve
$ git clone https://github.com/ailispaw/docker-root-xhyve
$ cd docker-root-xhyve
$ make init
$ sudo ./xhyverun.sh [<dir>]
Welcome to DockerRoot docker-root /dev/ttyS0
docker-root login:
or
$ [SHARED_FOLDER=<dir>] make up # You may be asked for your sudo password
Booting up...
- On Terminal.app: This will open a new window, then you will see in the window as below.
- On iTerm.app: This will split the current window, then you will see in the bottom pane as below.
Welcome to DockerRoot docker-root /dev/ttyS0
docker-root login:
- ID: docker
- Password: docker (in most instances you will not be prompted for a password)
$ make ssh
docker-root-xhyve: running on 192.168.64.2
[email protected]'s password:
Welcome to DockerRoot version 1.3.10, Docker version 1.9.1, build 66c06d0-stripped
[docker@docker-root ~]$
Use halt command to shut down in the VM:
[docker@docker-root ~]$ sudo halt
halt[316]: Stopping Docker daemon
docker[320]: Loading /var/lib/docker-root/profile
docker[320]: Stopping Docker daemon
halt[316]: Executing shutdown scripts in /etc/init.d
Stopping crond... OK
Stopping sshd... OK
Saving random seed... done.
halt[316]: halt
[docker@docker-root ~]$ reboot: System halted
$
or, use make halt on the host:
$ make halt
docker-root-xhyve: running on 192.168.64.2
[email protected]'s password:
halt[317]: Stopping Docker daemon
docker[321]: Loading /var/lib/docker-root/profile
docker[321]: Stopping Docker daemon
halt[317]: Executing shutdown scripts in /etc/init.d
Stopping crond... OK
Stopping sshd... OK
Saving random seed... done.
halt[317]: halt
Connection to 192.168.64.2 closed by remote host.
Shutting down...
You can simply run Docker within the VM. However, if you install the Docker client on the host, you can use Docker commands natively on the host Mac. Install the Docker client as follows:
$ curl -L https://get.docker.com/builds/Darwin/x86_64/docker-latest -o docker
$ chmod +x docker
$ mv docker /usr/local/bin/ # You may require sudo
Alternatively install with Homebrew:
$ brew install docker
Then, in the VM, or on the host if you have installed the Docker client:
$ make env
docker-root-xhyve: running on 192.168.64.2
export DOCKER_HOST=tcp:https://192.168.64.2:2375;
unset DOCKER_CERT_PATH;
unset DOCKER_TLS_VERIFY;
$ eval $(make env)
docker-root-xhyve: running on 192.168.64.2
$ docker info
Containers: 0
Images: 0
Server Version: 1.9.1
Storage Driver: overlay
Backing Filesystem: extfs
Execution Driver: native-0.2
Logging Driver: json-file
Kernel Version: 4.4.8-docker-root
Operating System: DockerRoot v1.3.10
CPUs: 1
Total Memory: 999.4 MiB
Name: docker-root
ID: H2SV:IRHA:ZJ23:J3CL:KLHE:V2IP:UML4:YPEE:TVW2:NT6V:QFAM:3X6I
Debug mode (server): true
File Descriptors: 12
Goroutines: 18
System Time: 2016-04-20T23:42:19.078377304Z
EventsListeners: 0
Init SHA1:
Init Path: /opt/bin/docker
Docker Root Dir: /mnt/vda1/var/lib/docker
When DockerRoot is upgraded and docker-root-xhyve is updated,
$ git pull origin master
$ make upgrade
$ make up
$ make ssh
[docker@docker-root ~]$ sudo cp /var/lib/docker-root/start.sh /var/lib/docker-root/start.old
[docker@docker-root ~]$ sudo wget -qO /var/lib/docker-root/start.sh https://raw.githubusercontent.com/ailispaw/docker-root-xhyve/master/contrib/configs/start.sh
[docker@docker-root ~]$ sudo chmod +x /var/lib/docker-root/start.sh
[docker@docker-root ~]$ sudo reboot
- /var/db/dhcpd_leases
- /Library/Preferences/SystemConfiguration/com.apple.vmnet.plist
- Shared_Net_Address
- Shared_Net_Mask