windows.rst 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. :title: Installation on Windows
  2. :description: Please note this project is currently under heavy development. It should not be used in production.
  3. :keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker
  4. .. _windows:
  5. Microsoft Windows
  6. =================
  7. Docker can run on Windows using a virtualization platform like VirtualBox. A Linux
  8. distribution is run inside a virtual machine and that's where Docker will run.
  9. Installation
  10. ------------
  11. .. include:: install_header.inc
  12. 1. Install VirtualBox from https://www.virtualbox.org - or follow this `tutorial <http://www.slideshare.net/julienbarbier42/install-virtualbox-on-windows-7>`_.
  13. 2. Download the latest boot2docker.iso from https://github.com/boot2docker/boot2docker/releases.
  14. 3. Start VirtualBox.
  15. 4. Create a new Virtual machine with the following settings:
  16. - `Name: boot2docker`
  17. - `Type: Linux`
  18. - `Version: Linux 2.6 (64 bit)`
  19. - `Memory size: 1024 MB`
  20. - `Hard drive: Do not add a virtual hard drive`
  21. 5. Open the settings of the virtual machine:
  22. 5.1. go to Storage
  23. 5.2. click the empty slot below `Controller: IDE`
  24. 5.3. click the disc icon on the right of `IDE Secondary Master`
  25. 5.4. click `Choose a virtual CD/DVD disk file`
  26. 6. Browse to the path where you've saved the `boot2docker.iso`, select the `boot2docker.iso` and click open.
  27. 7. Click OK on the Settings dialog to save the changes and close the window.
  28. 8. Start the virtual machine by clicking the green start button.
  29. 9. The boot2docker virtual machine should boot now.
  30. Running Docker
  31. --------------
  32. boot2docker will log you in automatically so you can start using Docker right
  33. away.
  34. Let's try the “hello world” example. Run
  35. .. code-block:: bash
  36. docker run busybox echo hello world
  37. This will download the small busybox image and print hello world.
  38. Observations
  39. ------------
  40. Persistent storage
  41. ``````````````````
  42. The virtual machine created above lacks any persistent data storage. All images
  43. and containers will be lost when shutting down or rebooting the VM.