64 lines
1.8 KiB
ReStructuredText
64 lines
1.8 KiB
ReStructuredText
|
|
.. _install_using_vagrant:
|
|
|
|
Install using Vagrant
|
|
=====================
|
|
|
|
Please note this is a community contributed installation path. The only 'official' installation is using the
|
|
:ref:`ubuntu_linux` installation path. This version may sometimes be out of date.
|
|
|
|
**requirements**
|
|
This guide will setup a new virtual machine with docker installed on your computer. This works on most operating
|
|
systems, including MacOX, Windows, Linux, FreeBSD and others. If you can install these and have at least 400Mb RAM
|
|
to spare you should be good.
|
|
|
|
|
|
Install Vagrant and Virtualbox
|
|
------------------------------
|
|
|
|
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
|
|
|
|
|
|
Spin up your machine
|
|
--------------------
|
|
|
|
1. Fetch the docker sources (this includes the instructions for machine setup).
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone https://github.com/dotcloud/docker.git
|
|
|
|
2. Run vagrant from the sources directory
|
|
|
|
.. code-block:: bash
|
|
|
|
vagrant up
|
|
|
|
Vagrant will:
|
|
|
|
* Download the 'official' Precise64 base ubuntu virtual machine image from vagrantup.com
|
|
* Boot this image in virtualbox
|
|
* Add the `Docker PPA sources <https://launchpad.net/~dotcloud/+archive/lxc-docker>`_ to /etc/apt/sources.lst
|
|
* Update your sources
|
|
* Install lxc-docker
|
|
|
|
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 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.
|