Legacy desktop solution. Docker Toolbox is for older Mac and Windows systems that do not meet the requirements of Docker Desktop for Mac and Docker Desktop for Windows. We recommend updating to the newer applications, if possible.
Docker toolbox installs Docker Machine and Virtualbox so you can run. Docker for Mac runs containers inside a Linux VM run using Mac OS X's built in. Docker for Mac is the current release of Docker for macOS. Docker Toolbox is a legacy desktop solution for older Mac and Windows systems that do not meet the requirements of Docker for Mac and You'll need homebrew-cask to install Docker Toolbox, if you don't have it refer to this section.
Estimated reading time: 1 minute Note while Docker Toolbox is now considered Legacy, Kitematic is still supported and available as a separate download from https://github.com/docker/kitematic
Available for both Windows and Mac, Docker Toolbox installs the Docker Client, Machine, Compose, and Kitematic.
Learn about Docker Toolbox. See Docker Toolbox Overview for a quick tour of Toolbox, andhow to get started with Docker Machine, Kitematic, and Docker Compose.
Ready to download Toolbox? See Install Docker Toolbox on macOS or Install Docker Toolbox on Windows for download and install instructions.
docker, documentation, about, technology, docker toolbox, guiEstimated reading time: 3 minutes On macOS and Windows, Machine is installed along with other Docker products whenyou install the Docker for Mac,Docker for Windows, orDocker Toolbox.
If you want only Docker Machine, you can install the Machine binaries directlyby following the instructions in the next section. You can find the latestversions of the binaries on the docker/machine releasepageon GitHub.
Install Machine directly
- Install Docker.
- Download the Docker Machine binary and extract it to your PATH.If you are running macOS:If you are running Linux:If you are running Windows with Git BASH:The above command works on Windows only if you use aterminal emulator such as Git BASH, which supports Linux commands like
chmod
.Otherwise, download one of the releases from the docker/machine releasepage directly. - Check the installation by displaying the Machine version:
Install bash completion scripts
The Machine repository supplies several
bash
scripts that add features suchas:- command completion
- a function that displays the active machine in your shell prompt
- a function wrapper that adds a
docker-machine use
subcommand to switch theactive machine
Confirm the version and save scripts to
/etc/bash_completion.d
or/usr/local/etc/bash_completion.d
:Then you need to run
source/etc/bash_completion.d/docker-machine-prompt.bash
in your bashterminal to tell your setup where it can find the filedocker-machine-prompt.bash
that you previously downloaded.![Docker Toolbox For Mac Osx Docker Toolbox For Mac Osx](https://docs.docker.com/docker-for-mac/images/menu/prefs-reset.png)
To enable the
docker-machine
shell prompt, add$(__docker_machine_ps1)
to your PS1
setting in ~/.bashrc
.You can find additional documentation in the comments at the top ofeachscript.
How to uninstall Docker Machine
To uninstall Docker Machine:
- Optionally, remove the machines you created.To remove each machine individually:
docker-machine rm <machine-name>
To remove all machines:docker-machine rm -f $(docker-machine ls-q)
(you might need to use-force
on Windows).Removing machines is an optional step because there are cases whereyou might want to save and migrate existing machines to a Dockerfor Mac or Docker Desktop forWindows environment, for example. - Remove the executable:
rm $(which docker-machine)
Note: As a point of information, the
config.json
, certificates,and other data related to each virtual machine created by docker-machine
is stored in ~/.docker/machine/machines/
on Mac and Linux and in~.dockermachinemachines
on Windows. We recommend that you do not edit orremove those files directly as this only affects information for the DockerCLI, not the actual VMs, regardless of whether they are local or on remoteservers.Where to go next
- Create and run a Docker host on your local system using virtualization
- Provision multiple Docker hosts on your cloud provider