macos.rst 1.8 KB

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