Windows toolbox migration instructions (#5939)

_data/toc.yaml

@@ -2939,6 +2939,8 @@ manuals:
     title: Install Docker for Windows
   - path: /docker-for-windows/kubernetes/
     title: Deploy on Kubernetes
+  - path: /docker-for-windows/docker-toolbox/
+    title: Migrate Docker Toolbox
   - path: /docker-for-windows/troubleshoot/
     title: Logs and troubleshooting
   - path: /docker-for-windows/faqs/

docker-for-windows/docker-toolbox.md

@@ -0,0 +1,40 @@
+---
+description: Docker for Windows and Docker Toolbox
+keywords: windows, alpha, beta, toolbox, docker-machine, tutorial
+title: Migrate Docker Toolbox
+---
+
+This page explains how to migrate your Docker Toolbox disk image, or images if
+you have them, to Docker for Windows.
+
+In version 18.01.0 and higher, the Docker for Windows installer no longer
+prompts users to migrate from Docker Toolbox--you must do so manually.
+
+## How to migrate Docker Toolbox disk images to Docker for Windows
+
+> **Warning**: Migrating disk images from Docker Toolbox _clobbers_ Docker
+> images if they exist. The migration process replaces the entire VM with your
+> previous Docker Toolbox data.
+
+1.  Install [qemu](https://www.qemu.org/){: target="_blank" class="_"} (a machine emulator): [https://cloudbase.it/downloads/qemu-img-win-x64-2_3_0.zip](https://cloudbase.it/downloads/qemu-img-win-x64-2_3_0.zip).
+2.  Install [Docker for Windows](/docker-for-windows/install/){: target="_blank" class="_"}.
+3.  Stop Docker for Windows, if running.
+4.  Move your current Docker VM disk to a safe location:
+
+    ```shell
+    mv 'C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks\MobyLinuxVM.vhdx' C:/<any directory>
+    ```
+
+5.  Convert your Toolbox disk image:
+
+    ```shell
+    qemu-img.exe convert 'C:\Users\<username>\.docker\machine\machines\default\disk.vmdk' -O vhdx -o subformat=dynamic -p 'C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks\MobyLinuxVM.vhdx'
+    ```
+
+6.  Restart Docker for Windows (with your converted disk).
+
+## How to uninstall Docker Toolbox
+
+Whether or not you migrate your Docker Toolbox images, you may decide to
+uninstall it. For details on how to perform a clean uninstall of Toolbox,
+see [How to uninstall Toolbox](/toolbox/toolbox_install_windows/#how-to-uninstall-toolbox){: target="_blank" class="_"}.