2013-03-26 02:52:52 +00:00
Mac OS X and other linux
========================
2013-03-26 19:00:46 +00:00
Please note this is a community contributed installation path. The only 'official' installation is using the :ref: `ubuntu_linux` installation path. This version
2013-03-26 15:50:34 +00:00
may be out of date because it depends on some binaries to be updated and published
2013-03-26 02:52:52 +00:00
Requirements
------------
We currently rely on some Ubuntu-linux specific packages, this will change in the future, but for now we provide a
streamlined path to install Virtualbox with a Ubuntu 12.10 image using Vagrant.
1. Install virtualbox from https://www.virtualbox.org/ (or use your package manager)
2. Install vagrant from http://www.vagrantup.com/ (or use your package manager)
3. Install git if you had not installed it before, check if it is installed by running
`` git `` in a terminal window
We recommend having at least about 2Gb of free disk space and 2Gb RAM (or more).
Installation
------------
1. Fetch the docker sources
.. code-block :: bash
git clone https://github.com/dotcloud/docker.git
2. Run vagrant from the sources directory
.. code-block :: bash
2013-03-26 22:24:26 +00:00
vagrant up
2013-03-26 02:52:52 +00:00
Vagrant will:
* Download the Quantal64 base ubuntu virtual machine image from get.docker.io/
* Boot this image in virtualbox
Then it will use Puppet to perform an initial setup in this machine:
* Download & untar the most recent docker binary tarball to vagrant homedir.
* Debootstrap to /var/lib/docker/images/ubuntu.
* Install & run dockerd as service.
* Put docker in /usr/local/bin.
* Put latest Go toolchain in /usr/local/go.
You now have a Ubuntu Virtual Machine running with docker pre-installed.
To access the VM and use Docker, Run `` vagrant ssh `` from the same directory as where you ran
`` vagrant up `` . Vagrant will make sure to connect you to the correct VM.
.. code-block :: bash
vagrant ssh
Now you are in the VM, run docker
.. code-block :: bash
docker
Continue with the :ref: `hello_world` example.