title: | Requirements and Installation on Mac OS X 10.6 Snow Leopard |
---|---|
description: | Please note this project is currently under heavy development. It should not be used in production. |
keywords: | Docker, Docker documentation, requirements, virtualbox, ssh, linux, os x, osx, mac |
Note
These instructions are available with the new release of Docker (version 0.8). However, they are subject to change.
Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer.
Docker on OS X needs VirtualBox to run. To begin with, head over to
VirtualBox Download Page and get the tool for OS X hosts x86/amd64
.
Once the download is complete, open the disk image, run the set up file
(i.e. VirtualBox.pkg
) and install VirtualBox. Do not simply copy the
package without running the installer.
boot2docker provides a handy script to easily manage the VM running the
docker
daemon. It also takes care of the installation for the OS image
that is used for the job.
Open up a new terminal window, if you have not already.
Run the following commands to get boot2docker:
# Enter the installation directory
cd ~/bin
# Get the file
curl https://raw.github.com/steeve/boot2docker/master/boot2docker > boot2docker
# Mark it executable
chmod +x boot2docker
The docker
daemon is accessed using the docker
client.
Run the following commands to get it downloaded and set up:
# Get the file
curl -o docker http://get.docker.io/builds/Darwin/x86_64/docker-latest
# Mark it executable
chmod +x docker
# Set the environment variable for the docker daemon
export DOCKER_HOST=tcp://
# Copy the executable file
sudo cp docker /usr/local/bin/
And that’s it! Let’s check out how to use it.
Inside the ~/bin
directory, run the following commands:
# Initiate the VM
./boot2docker init
# Run the VM (the docker daemon)
./boot2docker up
# To see all available commands:
./boot2docker
# Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download}
Once the VM with the docker
daemon is up, you can use the docker
client just like any other application.
docker version
# Client version: 0.7.6
# Go version (client): go1.2
# Git commit (client): bc3b2ec
# Server version: 0.7.5
# Git commit (server): c348c04
# Go version (server): go1.2
If you feel the need to connect to the VM, you can simply run:
./boot2docker ssh
# User: docker
# Pwd: tcuser
You can now continue with the :ref:`hello_world` example.
See the GitHub page for boot2docker.
ssh-keygen -R '[localhost]:2022'
Docker has two key components: the docker
daemon and the docker
client. The tool works by client commanding the daemon. In order to
work and do its magic, the daemon makes use of some Linux Kernel
features (e.g. LXC, name spaces etc.), which are not supported by OS X.
Therefore, the solution of getting Docker to run on OS X consists of
running it inside a lightweight virtual machine. In order to simplify
things, Docker comes with a bash script to make this whole process as
easy as possible (i.e. boot2docker).