1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798 |
- :title: Installing Docker on a Mac
- :description: Installing Docker on a Mac
- :keywords: Docker, Docker documentation, virtualbox, git, ssh
- .. _install_using_vagrant:
- Installing Docker on a Mac
- ==========================
- This guide explains how to install a full Docker setup on your Mac,
- using Virtualbox and Vagrant.
- Install Vagrant and Virtualbox
- ------------------------------
- .. include:: install_header.inc
- .. include:: install_unofficial.inc
- #. Install virtualbox from https://www.virtualbox.org/ (or use your
- package manager)
- #. Install vagrant from http://www.vagrantup.com/ (or use your package
- manager)
- #. Install git if you had not installed it before, check if it is
- installed by running ``git`` in a terminal window
- Spin it up
- ----------
- 1. Fetch the docker sources (this includes the ``Vagrantfile`` for
- machine setup).
- .. code-block:: bash
- git clone https://github.com/dotcloud/docker.git
- 2. Change directory to docker
- .. code-block:: bash
- cd docker
- 3. 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
- * Follow official :ref:`ubuntu_linux` installation path
- You now have a Ubuntu Virtual Machine running with docker pre-installed.
- Connect
- -------
- 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
- Upgrades
- --------
- Since your local VM is based on Ubuntu, you can upgrade docker by logging in to the
- VM and calling ``apt-get``:
- .. code-block:: bash
- # Log into the VM
- vagrant ssh
- # update your sources list
- sudo apt-get update
- # install the latest
- sudo apt-get install lxc-docker
- Run
- ---
- Now you are in the VM, run docker
- .. code-block:: bash
- sudo docker
- Continue with the :ref:`hello_world` example.
|