From 796ec3d67cc7f2dd0918a594db5ddafc689c9808 Mon Sep 17 00:00:00 2001 From: Victoria Bialas Date: Tue, 25 Oct 2016 16:42:03 -0700 Subject: [PATCH] incorporated Misty's rewrite from pr#256 with additional info Signed-off-by: Victoria Bialas --- machine/get-started.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/machine/get-started.md b/machine/get-started.md index 748f5a1f6b2..8e7442cc0b9 100644 --- a/machine/get-started.md +++ b/machine/get-started.md @@ -19,31 +19,30 @@ Docker host inside of a local virtual machine. With the advent of [Docker for Mac](/docker-for-mac/index.md) and [Docker for Windows](/docker-for-windows/index.md) as replacements for [Docker Toolbox](/toolbox/overview.md), we recommend that you use these for your primary -Docker workflows. +Docker workflows. You can use these applications to run Docker natively on your local system without using Docker Machine at all. (See [Docker for Mac vs. Docker Toolbox](docker-for-mac/docker-toolbox.md) for an explanation on the Mac side.) -However, Docker Machine is still available to create and manage machines for +However, if you want to create _multiple_ local machines, you need Docker Machine, which is still available to create and manage machines for power users or multi-node experimentation. Both Docker for Mac and Docker for Windows include the newest version of Docker Machine, so when you install either of these, you get `docker-machine`. The new solutions come with their own native virtualization solutions rather -than using Oracle VirtualBox, so there are new considerations to keep in mind -when using Machine to create local VMs. Docker for Mac allows for the creation -of additional `docker-machine` based `virtualbox` machines without issue, but in -the case of Docker for Windows, you will need to use the `hyperv` driver -instead. +than Oracle VirtualBox, so keep the following considerations in mind when using +Machine to create local VMs. +* **Docker for Mac** - You can use `docker-machine --create` with the `virtualbox` driver to create additional local machines. + +* **Docker for Windows** - You can use `docker-machine --create` with the `hyperv` driver to create additional local machines. #### If you are using Docker for Windows Docker for Windows uses [Microsoft Hyper-V](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/windows_welcome) -for virtualization, and Hyper-V and Oracle VirtualBox are incompatible. +for virtualization, and Hyper-V is not compatible with Oracle VirtualBox. Therefore, you cannot run the two solutions simultaneously. But you can still -use `docker-machine` to create local VMs by using the Microsoft Hyper-V driver. +use `docker-machine` to create more local VMs by using the Microsoft Hyper-V driver. -* If you are using Docker for Windows, the only prequisite is to have Docker for Windows installed. You will use the Microsoft `hyperv` driver to create -local machines. (See the [Docker Machine driver for Microsoft +* If you are using Docker for Windows, the only prerequisite is to have Docker for Windows installed. If you want to create multiple local machines, use the Microsoft `hyperv` driver to create them. (See the [Docker Machine driver for Microsoft Hyper-V](drivers/hyper-v.md).) #### If you are using Docker for Mac