189 lines
6.6 KiB
Markdown
189 lines
6.6 KiB
Markdown
|
---
|
||
|
|
description: Docker Desktop for Windows and Docker Toolbox
|
||
|
|
keywords: windows, alpha, beta, toolbox, docker-machine, tutorial
|
||
|
|
sitemap: false
|
||
|
|
title: Docker Toolbox
|
||
|
|
redirect_from:
|
||
|
|
- /toolbox/
|
||
|
|
- /toolbox/overview/
|
||
|
|
- /toolbox/toolbox_install_mac/
|
||
|
|
- /toolbox/toolbox_install_windows/
|
||
|
|
- /toolbox/faqs/
|
||
|
|
- /toolbox/faqs/troubleshoot/
|
||
|
|
- /docker-for-mac/docker-toolbox/
|
||
|
|
toc_min: 1
|
||
|
|
toc_max: 2
|
||
|
|
---
|
||
|
|
|
||
|
|
>**Deprecated**
|
||
|
|
>
|
||
|
|
> Docker Toolbox has been deprecated and is no longer in active development. Please use Docker Desktop instead. See [Docker Desktop for Mac](../docker-for-mac/index.md) and [Docker Desktop for Windows](../docker-for-windows/index.md).
|
||
|
|
{: .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](#uninstall-docker-toolbox-on-windows) 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](../docker-for-mac/index.md), 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](../docker-for-windows/index.md), 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.
|