diff --git a/_data/toc.yaml b/_data/toc.yaml index 04189b2849..8e36727839 100644 --- a/_data/toc.yaml +++ b/_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/ diff --git a/docker-for-windows/docker-toolbox.md b/docker-for-windows/docker-toolbox.md new file mode 100644 index 0000000000..5fd859006e --- /dev/null +++ b/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:/ + ``` + +5. Convert your Toolbox disk image: + + ```shell + qemu-img.exe convert 'C:\Users\\.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="_"}.