mirror of https://github.com/docker/docs.git
146 lines
7.2 KiB
Markdown
146 lines
7.2 KiB
Markdown
---
|
||
description: How to install Docker Desktop on Windows 10 Home
|
||
keywords: Windows 10 Home, Home, Windows, install, download, run, Docker, local
|
||
title: Install Docker Desktop on Windows Home
|
||
---
|
||
|
||
You can now install Docker Desktop on Windows Home machines using the WSL 2 backend.
|
||
Docker Desktop on Windows Home is a full version of Docker Desktop for Linux container
|
||
development.
|
||
|
||
This page contains information on installing Docker Desktop on Windows 10 Home.
|
||
If you are looking for information about installing Docker Desktop on Windows 10
|
||
Pro, Enterprise, or Education, see [Install Docker Desktop on Windows](install.md).
|
||
|
||
[Download from Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-windows/){:
|
||
.button .outline-btn}
|
||
|
||
Docker Desktop on Windows Home offers the following benefits:
|
||
|
||
- Latest version of Docker on your Windows Home machine
|
||
- Install Kubernetes in one click on Windows Home
|
||
- Integrated UI to view and manage your running containers
|
||
- Start Docker Desktop in less than ten seconds
|
||
- Use Linux Workspaces
|
||
- Dynamic resource and memory allocation
|
||
- Networking stack, support for http proxy settings, and trusted CA synchronization
|
||
|
||
For detailed information about WSL 2, see [Docker Desktop WSL 2 backend](wsl.md)
|
||
|
||
## What to know before you install
|
||
|
||
### System Requirements
|
||
|
||
Windows 10 Home machines must meet the following requirements to install Docker Desktop:
|
||
|
||
- Install Windows 10, version 1903 or higher.
|
||
- Enable the WSL 2 feature on Windows. For detailed instructions, refer to the
|
||
[Microsoft documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
|
||
- The following hardware prerequisites are required to successfully run
|
||
WSL 2 on Windows 10 Home:
|
||
|
||
- 64 bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation)
|
||
- 4GB system RAM
|
||
- BIOS-level hardware virtualization support must be enabled in the
|
||
BIOS settings. For more information, see
|
||
[Virtualization](troubleshoot.md#virtualization-must-be-enabled).
|
||
- Download and install the [Linux kernel update package](https://docs.microsoft.com/windows/wsl/wsl2-kernel).
|
||
|
||
> **Note**
|
||
>
|
||
> Docker supports Docker Desktop on Windows for those versions of Windows 10 that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet).
|
||
|
||
### What's included in the installer
|
||
|
||
The Docker Desktop installation includes [Docker Engine](../engine/index.md),
|
||
Docker CLI client, [Docker Compose](../compose/index.md),
|
||
[Notary](../notary/getting_started.md),
|
||
[Kubernetes](https://github.com/kubernetes/kubernetes/),
|
||
and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
|
||
|
||
Nested virtualization scenarios, such as running Docker Desktop on a
|
||
VMWare or Parallels instance might work, but there are no guarantees. For
|
||
more information, see [Running Docker Desktop in nested virtualization scenarios](troubleshoot.md#running-docker-desktop-in-nested-virtualization-scenarios).
|
||
|
||
## Install Docker Desktop on Windows 10 Home
|
||
|
||
1. Double-click **Docker Desktop Installer.exe** to run the installer.
|
||
|
||
If you haven't already downloaded the installer (`Docker Desktop Installer.exe`), you can get it from
|
||
[**Docker Hub**](https://hub.docker.com/editions/community/docker-ce-desktop-windows/).
|
||
It typically downloads to your `Downloads` folder, or you can run it from
|
||
the recent downloads bar at the bottom of your web browser.
|
||
|
||
2. When prompted, ensure the **Enable WSL 2 Features** option is selected on the Configuration page.
|
||
|
||
3. Follow the instructions on the installation wizard authorize the installer and proceed with the install.
|
||
|
||
4. When the installation is successful, click **Close** to complete the installation process.
|
||
|
||
## Start Docker Desktop
|
||
|
||
Docker Desktop does not start automatically after installation. To start Docker Desktop, search for Docker, and select **Docker Desktop** in the search results.
|
||
|
||
{:width="300px"}
|
||
|
||
When the whale icon in the status bar stays steady, Docker Desktop is up-and-running, and is accessible from any terminal window.
|
||
|
||
|
||
|
||
When the initialization is complete, Docker Desktop launches the onboarding tutorial. The tutorial includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
|
||
|
||
{:width="450px"}
|
||
|
||
Congratulations! You are now successfully running Docker Desktop on Windows Home.
|
||
|
||
## Automatic updates
|
||
|
||
Starting with Docker Desktop 3.0.0, updates to Docker Desktop will be available automatically as delta updates from the previous version.
|
||
|
||
When an update is available, Docker Desktop automatically downloads it to your machine and displays an icon to indicate the availability of a newer version. All you need to do now is to click **Update and restart** from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
|
||
|
||
## Uninstall Docker Desktop
|
||
|
||
To uninstall Docker Desktop from your Windows Home machine:
|
||
|
||
1. From the Windows **Start** menu, select **Settings** > **Apps** > **Apps & features**.
|
||
2. Select **Docker Desktop** from the **Apps & features** list and then select **Uninstall**.
|
||
3. Click **Uninstall** to confirm your selection.
|
||
|
||
> **Note**
|
||
>
|
||
> Uninstalling Docker Desktop will destroy Docker containers and images local to the machine and remove the files generated by the application.
|
||
|
||
### Save and restore data
|
||
|
||
You can use the following procedure to save and restore images and container data. For example, to reset your VM disk:
|
||
|
||
1. Use `docker save -o images.tar image1 [image2 ...]` to save any images you
|
||
want to keep. See [save](../engine/reference/commandline/save.md) in the Docker
|
||
Engine command line reference.
|
||
|
||
2. Use `docker export -o myContainner1.tar container1` to export containers you
|
||
want to keep. See [export](../engine/reference/commandline/export.md) in the
|
||
Docker Engine command line reference.
|
||
|
||
3. Uninstall the current version of Docker Desktop and install a different version, or reset your VM disk.
|
||
|
||
4. Use `docker load -i images.tar` to reload previously saved images. See
|
||
[load](../engine/reference/commandline/load.md) in the Docker Engine.
|
||
|
||
5. Use `docker import -i myContainer1.tar` to create a file system image
|
||
corresponding to the previously exported containers. See
|
||
[import](../engine/reference/commandline/import.md) in the Docker Engine.
|
||
|
||
For information on how to back up and restore data volumes, see [Backup, restore, or migrate data volumes](../storage/volumes.md#backup-restore-or-migrate-data-volumes).
|
||
|
||
## Where to go next
|
||
|
||
* [Getting started](index.md) introduces Docker Desktop for Windows.
|
||
* [Get started with Docker](../get-started/index.md) is a tutorial that teaches
|
||
you how to deploy a multi-service stack.
|
||
* [Troubleshooting](troubleshoot.md) describes common problems, workarounds, and
|
||
how to get support.
|
||
* [FAQs](../desktop/faqs.md) provides answers to frequently asked questions.
|
||
* [Release notes](release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
|