9f78769fba
Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit) Upstream-commit: 5f5d66ade63f8040dd14114f2c7161b16a806c5c Component: engine
2.5 KiB
page_title: Installation on Mac OS X page_description: Instructions for installing Docker on OS X using boot2docker. page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac
Installing Docker on Mac OS X
Note
: Docker is still under heavy development! We don't recommend using it in production yet, but we're getting closer with each release. Please see our blog post, Getting to Docker 1.0
Note: Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer.
The Docker Engine uses Linux-specific kernel features, so we run it on OS X using a lightweight virtual machine. You can use the OS X Docker client to control the virtualized engine to build, run and manage Docker containers.
To make this process easier we designed a helper application called boot2docker to install the virtual machine and run the Docker daemon.
Installation
- Download the latest release of the Docker for OSX Installer
- Run the installer, which will install VirtualBox and the Boot2Docker management
tool.
- Open a terminal and run:
boot2docker init
boot2docker start
export DOCKER_HOST=tcp://localhost:4243
boot2docker init will ask you to enter an ssh key passphrase - the simplest
(but least secure) is to just hit [Enter]. This passphrase is used by the
boot2docker ssh command.
Once you have an initialized virtual machine, you can boot2docker stop and
boot2docker start it.
Upgrading
To upgrade:
- Download the latest release of the Docker for OSX Installer
- Run the installer, which will update VirtualBox and the Boot2Docker management tool.
- To upgrade your existing virtual machine, open a terminal and run:
boot2docker stop
boot2docker download
boot2docker start
Running Docker
From your terminal, you can try the “hello world” example. Run:
$ docker run ubuntu echo hello world
This will download the ubuntu image and print hello world.
Further details
The Boot2Docker management tool provides some commands:
$ ./boot2docker
Usage: ./boot2docker [<options>] {help|init|up|ssh|save|down|poweroff|reset|restart|config|status|info|delete|download|version} [<args>]
For further information or to report issues, please see the Boot2Docker site.