Docker Toolbox

One of the new features introduced in Docker 1.8 is Docker Toolbox. What is this toolbox?

Docker Toolbox

The Docker Toolbox is an installer to quickly and easily install and setup a Docker environment on your computer. Available for both Windows and Mac, the Toolbox installs Docker Client, Machine, Compose (Mac only), Kitematic and VirtualBox.

Docker Toolbox

Docker Toolbox is the fastest way to get up and running with Docker in development. In short, it provides the different tools required to get started with Docker:

  • Docker Client docker binary
  • Docker Machine docker-machine binary
  • Docker Compose docker-compose binary
  • Kitematic – Desktop GUI for Docker
  • Docker Quickstart Terminal app

If you have Docker CLI, Machine, Compose, and other tools installed in the /usr/local/bin directory then this would just overwrite them.

Specifically, Docker Toolbox 1.8.0a installs:

  • Docker Client 1.8.0
  • Docker Machine 0.4.0
  • Docker Compose 1.4.0
  • Docker Quickstart Terminal App
  • Kitematic 0.8.1
  • Virtual 5.0.0

After the installation completes, the versions are shown as:

If an older version of VirtualBox is already running then it will show a message as shown:

This flow needs to be slightly cleaned up (#63).

Read more details in DockerToolbox blog.

UPDATE: Virtual Box 5.0.0 prohibits Kubernetes cluster from starting. Not sure if Docker 1.8.0 will work with Virtual Box 4.3.30 but I downgraded VirtualBox 5.0.0 to 4.3.30 and also downgraded Docker 1.8.0 to 1.7.0 as explained in #12614.

Docker Quickstart Terminal

It also created a new Docker category in Applications with links to Docker Quickstart Terminal and Kitematic. Clicking on the terminal app creates a default Machine instance and shows the following output:

The configured Docker environment variables are:

VirtualBox is also updated to 5.0.0 r101573.

The Quickstart Terminal is mostly a regular shell but allows to create a default machine. It can be used to connect to other machines as well:

Update existing Docker scripts to Docker 1.8

If you’d like to update existing Docker scripts to 1.8, then they are available at:

  • Docker Client 1.8.0 (for Mac)
  • Docker Compose 1.4.0
  • Docker Machine 0.4.0
  • VirtualBox 5.0.0

Upgrade Docker CLI:

Upgrade Docker Machine:

Upgrade Docker Compose:

Virtual Box needs can be downloaded from

Upgrade Docker VMs

Docker version of existing Machines can be found as:

This can only be done after the machine is running though.

So start an existing machine as:

And then upgrade it as:

Java Applications using Docker

Ready to start deploying your Java applications to Docker?

Get started with

Be Sociable, Share!
  • Tweet

4 thoughts on “Docker Toolbox

Leave a Reply

Your email address will not be published. Required fields are marked *