Mac OS X

You have two options for installing Docker on Mac:

Docker for Mac

Docker for Mac is our newest offering for the Mac. It runs as a native Mac application and uses xhyve to virtualize the Docker Engine environment and Linux kernel-specific features for the Docker daemon.

Go to Getting Started with Docker for Mac for download and install instructions, and to learn all about Docker for Mac.

Requirements

  • Mac must be a 2010 or newer model, with Intel’s hardware support for memory management unit (MMU) virtualization; i.e., Extended Page Tables (EPT)

  • OS X 10.10.3 Yosemite or newer

  • At least 4GB of RAM

  • VirtualBox prior to version 4.3.30 must NOT be installed (it is incompatible with Docker for Mac). Docker for Mac will error out on install in this case. Uninstall the older version of VirtualBox and re-try the install.

Docker Toolbox

If you have an earlier Mac that doesn’t meet the Docker for Mac requirements, get Docker Toolbox for the Mac.

See Docker Toolbox Overview for help on installing Docker with Toolbox.

The Docker Toolbox setup does not run Docker natively in OS X. Instead, it uses docker-machine to create and attach to a virtual machine (VM). This machine is a Linux VM that hosts Docker for you on your Mac.

Requirements

Your Mac must be running OS X 10.8 “Mountain Lion” or newer to install the Docker Toolbox. Full install instructions are at Toolbox install instructions for Mac.

Learning more

Note: The Boot2Docker command line was deprecated several releases > back in favor of Docker Machine, and now Docker for Windows.