mirror of https://github.com/docker/docs.git
Combine Windows install pages (#12531)
* Combine Windows install pages Signed-off-by: Usha Mandya <usha.mandya@docker.com> * Apply suggestions from code review Co-authored-by: Stefan Scherer <stefan.scherer@docker.com> * Apply suggestions from code review Co-authored-by: Stefan Scherer <stefan.scherer@docker.com> * Some more minor updates to improve readability Signed-off-by: Usha Mandya <usha.mandya@docker.com> Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
This commit is contained in:
Usha Mandya
GitHub
parent
5032901ee9
commit
c2ff6bf292
|
|
@ -1286,8 +1286,6 @@ manuals:
|
|||
section:
|
||||
- path: /docker-for-windows/install/
|
||||
title: Install Docker Desktop for Windows
|
||||
- path: /docker-for-windows/install-windows-home/
|
||||
title: Install Docker Desktop on Windows Home
|
||||
- path: /docker-for-windows/
|
||||
title: User manual
|
||||
- path: /docker-for-windows/kubernetes/
|
||||
|
|
|
|||
|
|
@ -1,145 +0,0 @@
|
|||
---
|
||||
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.
|
||||
|
|
@ -2,36 +2,53 @@
|
|||
description: How to install Docker Desktop for Windows
|
||||
keywords: windows, install, download, run, docker, local
|
||||
title: Install Docker Desktop on Windows
|
||||
redirect_from:
|
||||
- /docker-for-windows/install-windows-home/
|
||||
---
|
||||
|
||||
Docker Desktop for Windows is the [Community](https://www.docker.com/community-edition) version of Docker for Microsoft Windows.
|
||||
You can download Docker Desktop for Windows from Docker Hub.
|
||||
|
||||
This page contains information on installing Docker Desktop on Windows 10 Pro, Enterprise, and Education. If you are looking for information about installing Docker Desktop on Windows 10 Home, see [Install Docker Desktop on Windows Home](/install-windows-home.md).
|
||||
|
||||
[Download from Docker
|
||||
Hub](https://hub.docker.com/editions/community/docker-ce-desktop-windows/){:
|
||||
.button .outline-btn}
|
||||
|
||||
By downloading Docker Desktop, you agree to the terms of the [Docker Software End User License Agreement](https://www.docker.com/legal/docker-software-end-user-license-agreement){: target="_blank" rel="noopener" class="_"} and the [Docker Data Processing Agreement](https://www.docker.com/legal/data-processing-agreement){: target="_blank" rel="noopener" class="_"}.
|
||||
|
||||
## What to know before you install
|
||||
## System requirements
|
||||
|
||||
### System Requirements
|
||||
Your Windows machine must meet the following requirements to successfully install Docker Desktop.
|
||||
|
||||
- Windows 10 64-bit: Pro, Enterprise, or Education (Build 17134 or later).
|
||||
|
||||
For Windows 10 Home, see [Install Docker Desktop on Windows Home](install-windows-home.md).
|
||||
- Hyper-V and Containers Windows features must be enabled.
|
||||
- The following hardware prerequisites are required to successfully run Client
|
||||
### Hyper-V backend and Windows containers
|
||||
|
||||
- Windows 10 64-bit: Pro, Enterprise, or Education (Build 17134 or higher).
|
||||
|
||||
For Windows 10 Home, see [System requirements for WSL 2 backend](#system-requirements-for-wsl-2-backend).
|
||||
- Hyper-V and Containers Windows features must be enabled.
|
||||
- The following hardware prerequisites are required to successfully run Client
|
||||
Hyper-V on Windows 10:
|
||||
|
||||
- 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
|
||||
- 64 bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation){: target="_blank" rel="noopener" class="_"}
|
||||
- 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).
|
||||
|
||||
### WSL 2 backend
|
||||
|
||||
- Windows 10 64-bit: Home, Pro, Enterprise, or Education, version 1903 (Build 18362 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){: target="_blank" rel="noopener" class="_"}.
|
||||
- The following hardware prerequisites are required to successfully run
|
||||
WSL 2 on Windows 10:
|
||||
|
||||
- 64-bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation){: target="_blank" rel="noopener" class="_"}
|
||||
- 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){: target="_blank" rel="noopener" class="_"}.
|
||||
|
||||
> **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){:target="_blank" rel="noopener" class="_"}.
|
||||
|
|
@ -73,15 +90,13 @@ Looking for information on using Windows containers?
|
|||
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 Hyper-V Windows Features** option is selected on the Configuration page.
|
||||
2. When prompted, ensure the **Enable Hyper-V Windows Features** or the **Install required Windows components for WSL 2** option is selected on the Configuration page.
|
||||
|
||||
3. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
|
||||
|
||||
4. When the installation is successful, click **Close** to complete the installation process.
|
||||
|
||||
5. If your admin account is different to your user account, you must add the user to
|
||||
the **docker-users** group. Run **Computer Management** as an administrator and navigate to
|
||||
**Local Users and Groups** > **Groups** > **docker-users**. Right-click to add the user to the group.
|
||||
5. If your admin account is different to your user account, you must add the user to the **docker-users** group. Run **Computer Management** as an administrator and navigate to **Local Users and Groups** > **Groups** > **docker-users**. Right-click to add the user to the group.
|
||||
Log out and log back in for the changes to take effect.
|
||||
|
||||
## Start Docker Desktop
|
||||
|
|
@ -103,8 +118,7 @@ When the initialization is complete, Docker Desktop launches the onboarding tuto
|
|||
|
||||
Congratulations! You are now successfully running Docker Desktop on Windows.
|
||||
|
||||
If you would like to rerun the tutorial, go to the Docker Desktop menu
|
||||
and select **Learn**.
|
||||
If you would like to rerun the tutorial, go to the Docker Desktop menu and select **Learn**.
|
||||
|
||||
## Automatic updates
|
||||
|
||||
|
|
@ -127,7 +141,6 @@ To uninstall Docker Desktop from your Windows machine:
|
|||
> by the application. Refer to the [back up and restore data](../desktop/backup-and-restore.md)
|
||||
> section to learn how to preserve important data before uninstalling.
|
||||
|
||||
|
||||
## Where to go next
|
||||
|
||||
* [Getting started](index.md) introduces Docker Desktop for Windows.
|
||||
|
|
@ -135,7 +148,6 @@ To uninstall Docker Desktop from your Windows machine:
|
|||
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.
|
||||
* [FAQs](../desktop/faqs.md) provide answers to frequently asked questions.
|
||||
* [Release notes](release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
|
||||
* [Back up and restore data](../desktop/backup-and-restore.md) provides instructions
|
||||
on backing up and restoring data related to Docker.
|
||||
* [Back up and restore data](../desktop/backup-and-restore.md) provides instructions on backing up and restoring data related to Docker.
|
||||
|
|
|
|||
|
|
@ -341,7 +341,7 @@ the `--privileged` flag. See [docker/for-win#8326](https://github.com/docker/for
|
|||
|
||||
### New
|
||||
|
||||
- Windows 10 Home users can now use Docker Desktop through WSL 2. This requires Windows 10, version 2004 or higher. For more information, see [Install Docker Desktop on Windows Home](install-windows-home.md).
|
||||
- Windows 10 Home users can now use Docker Desktop through WSL 2. This requires Windows 10, version 2004 or higher. For more information, see [Install Docker Desktop on Windows](install.md).
|
||||
- Docker Desktop introduces a new onboarding tutorial upon first startup. The Quick Start tutorial guides users to get started with Docker in a few easy steps. It includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
|
||||
- Docker Desktop now allows sharing individual folders, rather than whole drives, giving more control to users over what is being shared.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue