This is a fork of Docker Toolbox (https://github.com/docker/toolbox)
See Ceasing Support and Development of Docker Toolbox #898
Why a fork? I still find it useful.
NOTE:
Releases >= 20.10.9:
docker-machine has now been patched to pull the boot2docker-xfs-ng ISO from the kaosagnt/boot2docker-xfs-ng repository.
This version of docker-machine contains all patches from the GitLab fork and contains other fixes on top. It will continue to pull in patches from GitLab. The Source tree can be found at kaosagnt/docker-machine.
Previous releases <=20.10.8:
docker-machine will pull by default the obsoleted boot2docker project ISO.
To get around this issue you will need to use the docker-machine option to point the URL to the boot2docker.iso file that ships with this toolbox2docker distribution and manually create a virtual machine.
docker-machine create -d ${VIRTUAL_DRIVER} ${VIRTUAL_MEMORY} \
--${VIRTUAL_DRIVER}-boot2docker-url "file://some/path/to/file" \
${VIRTUAL_CPU_COUNT} ${VIRTUAL_SWITCH} ${VM_MACHINE_NAME}
--${VIRTUAL_DRIVER}-boot2docker-url "file://path/to/boot2docker.iso"
where ${VIRTUAL_driver} is the driver for the Virtual machine software you are using
virtualbox
vmware
vmwarefusion
hyperv
This will also give your VM the XFS filesystem instead of EXT4 as it will be created with the correct ISO.
The location of the boot2docker ISO on a default install:
macOS: /usr/local/share/boot2docker/boot2docker.iso
windows: /c/Program Files/toolbox2docker/boot2docker.iso
NOTE: Virtualbox on macOS requires manual intervention to workaround a Virtualbox security feature. See:
(default) Found a new host-only adapter: "vboxnet0"
Error creating machine: Error in driver during machine creation: Error setting up host only network on machine start: /usr/local/bin/VBoxManage hostonlyif ipconfig vboxnet0 --ip 192.168.99.1 --netmask 255.255.255.0 failed:
VBoxManage: error: Code E_ACCESSDENIED (0x80070005) - Access denied (extended info not available)
VBoxManage: error: Context: "EnableStaticIPConfig(Bstr(pszIp).raw(), Bstr(pszNetmask).raw())" at line 242 of file VBoxManageHostonly.cpp
Before running the "Docker Quickstart Terminal" for the first time, follow the insrtuctions in the Virtualbox Manual
Section: 6.7. Host-Only Networking
On Linux, Mac OS X and Solaris Oracle VM VirtualBox will only allow IP addresses in 192.168.56.0/21 range to be assigned to host-only adapters. For IPv6 only link-local addresses are allowed. If other ranges are desired, they can be enabled by creating /etc/vbox/networks.conf and specifying allowed ranges there. For example, to allow 10.0.0.0/8 and 192.168.0.0/16 IPv4 ranges as well as 2001::/64 range put the following lines into /etc/vbox/networks.conf:
* 10.0.0.0/8 192.168.0.0/16
* 2001::/64
Lines starting with the hash # are ignored. Next example allows any addresses, effectively disabling range control:
* 0.0.0.0/0 ::/0
If the file exists, but no ranges are specified in it, no addresses will be assigned to host-only adapters. The following example effectively disables all ranges:
# No addresses are allowed for host-only adapters
XXX TODO: fix documentation
The Toolbox2docker installs everything you need to get started with Docker on Mac OS X and Windows. It includes the Docker client, Compose, Machine and VirtualBox.
Documentation for Mac is available here.
Documentation for Windows is available here.
Note: Some Windows and Mac computers may not have VT-X enabled by default. It is required for VirtualBox. To check if VT-X is enabled on Windows follow this guide here. To enable VT-X on Windows, please see the guide here. To enable VT-X on Intel-based Macs, refer to this Apple guide here. Also note that if the Virtual Machine was created before enabling VT-X it can be necessary to remove and reinstall the VM for Docker Toolbox to work.
Toolbox is currently unavailable for Linux; To get started with Docker on Linux, please follow the Linux Getting Started Guide.
Toolbox2docker installers are built using Docker, so you'll need a Docker host set up. For example, using Docker Machine:
$ docker-machine create -d virtualbox toolbox
$ eval "$(docker-machine env toolbox)"
Then, to build Toolbox2docker for both platforms:
make
Build for a specific platform:
make osx
or
make windows
The resulting installers will be in the dist directory.
Do I have to install VirtualBox?
No, you can deselect VirtualBox during installation. It is bundled in case you want to have a working environment for free.