docker-docs/docker-for-windows/docker-toolbox.md

description, keywords, sitemap, title, redirect_from, toc_min, toc_max

description	keywords	sitemap	title	redirect_from	toc_min	toc_max
Docker Desktop for Windows and Docker Toolbox	windows, alpha, beta, toolbox, docker-machine, tutorial	false	Docker Toolbox	/toolbox/ /toolbox/overview/ /toolbox/toolbox_install_mac/ /toolbox/toolbox_install_windows/ /toolbox/faqs/ /toolbox/faqs/troubleshoot/ /docker-for-mac/docker-toolbox/	1	2

Deprecated

Docker Toolbox has been deprecated and is no longer in active development. Please use Docker Desktop instead. See Docker Desktop for Mac and Docker Desktop for Windows. {: .warning }

This page explains how to migrate your Docker Toolbox disk images to Docker Desktop. It also contains instructions on how to uninstall Docker Toolbox from Mac and Windows machines.

Migrate from Docker Toolbox to Docker Desktop on Mac

You can migrate existing Docker Toolbox images with the steps described below.

In a terminal, while running Toolbox, use docker commit to create an image snapshot from a container, for each container you wish to preserve:

$ docker commit nginx
sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Next, export each of these images (and any other images you wish to keep):

$ docker save -o nginx.tar sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Next, when running Docker Desktop on Mac, reload all these images:

$ docker load -i nginx.tar
Loaded image ID: sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Note these steps will not migrate any docker volume contents: these must be copied across manually.

Finally (optional), if you are done with Docker Toolbox, you can fully uninstall Docker Toolbox using the instructions described in the following section.

Migrate from Docker Toolbox to Docker Desktop on Windows

You can migrate existing Docker Toolbox images with the steps described below.

In a terminal, while running Toolbox, use docker commit to create an image snapshot from a container, for each container you wish to preserve:

> docker commit nginx
sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Next, export each of these images (and any other images you wish to keep):

> docker save -o nginx.tar sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Next, when running Docker Desktop on Windows, reload all these images:

> docker load -i nginx.tar
Loaded image ID: sha256:1bc0ee792d144f0f9a1b926b862dc88b0206364b0931be700a313111025df022

Note these steps will not migrate any docker volume contents: these must be copied across manually.

Uninstall Docker Toolbox

Removing Toolbox involves removing all the Docker components it includes.

A full uninstall also includes removing the local and remote machines you created with Docker Machine. In some cases, you might want to keep machines created with Docker Machine. For example, if you plan to re-install Docker Machine as a part of Docker Desktop, you can continue to manage those machines through Docker. Or, if you have remote machines on a cloud provider and you plan to manage them using the provider, you wouldn't want to remove them. So, the step to remove machines is described here as optional.

Uninstall Docker Toolbox on Mac

To uninstall Docker Toolbox on Mac:

1. List your machines.

   $ docker-machine ls
   NAME                ACTIVE   DRIVER       STATE     URL                        SWARM
   dev                 *        virtualbox   Running   tcp://192.168.99.100:2376
   my-docker-machine            virtualbox   Stopped
   default                      virtualbox   Stopped
   

2. Optionally, remove each machine. For example:

   $ docker-machine rm my-docker-machine
   Successfully removed my-docker-machine
   

   This step is optional because if you plan to re-install Docker Machine as a part of Docker Desktop for Mac, you can import and continue to manage those machines through Docker.

3. In your "Applications" folder, remove the "Docker" directory, which contains "Docker Quickstart Terminal" and "Kitematic".

4. Run the following in a command shell to fully remove Kitematic:

   $ rm -fr ~/Library/Application\ Support/Kitematic
   

5. Remove the docker, docker-compose, and docker-machine commands from the /usr/local/bin folder. Docker Desktop for Mac and Brew may also have installed them; in case of doubt leave them, or reinstall them via Brew, or rerun Docker Desktop for Mac (no need to reinstall it).

   $ rm -f /usr/local/bin/docker
   $ rm -f /usr/local/bin/docker-compose
   $ rm -f /usr/local/bin/docker-machine
   

6. Optionally, remove the ~/.docker/machine directory.

   This directory stores some configuration and/or state, such as information about created machines and certificates.

7. Uninstall Oracle VirtualBox, which is installed as a part of the Toolbox install.

Uninstall Docker Toolbox on Windows

To uninstall Toolbox on Windows:

1. List your machines.

   $ docker-machine ls
   NAME                ACTIVE   DRIVER       STATE     URL                        SWARM
   dev                 *        virtualbox   Running   tcp://192.168.99.100:2376
   my-docker-machine            virtualbox   Stopped
   default                      virtualbox   Stopped
   

2. Optionally, remove each machine. For example:

   $ docker-machine rm my-docker-machine
   Successfully removed my-docker-machine
   

   This step is optional because if you plan to re-install Docker Machine as a part of Docker Desktop for Windows, you can import and continue to manage those machines through Docker.

3. Uninstall Docker Toolbox using Window's standard process for uninstalling programs through the control panel (programs and features).

   Note

   : This process does not remove the docker-install.exe file. You must delete that file yourself.

4. Optionally, remove the C:\Users\<your-user>\.docker directory.

   If you want to remove Docker entirely, you can verify that the uninstall removed the .docker directory under your user path. If it is still there, remove it manually. This directory stores some Docker program configuration and state, such as information about created machines and certificates. You usually don't need to remove this directory.

5. Uninstall Oracle VirtualBox, which is installed as a part of the Toolbox install.