Reading Time: 4 mins.
After downloading its stable version for Windows 10, install and configure Docker Desktop application, as illustrated below. Then, double-click on the created shortcut for Docker Desktop on your. Windows 10 64-bit: Pro, Enterprise, or Education (Build 17134 or later).For Windows 10 Home, see Install Docker Desktop on Windows Home. Hyper-V and Containers Windows features must be enabled. The following hardware prerequisites are required to successfully run Client Hyper-V on Windows 10.
Docker, a powerful and flexible software supports cross-platform and execution on a Windows host, including Windows 10 (Pro or Enterprise) which in turn makes Windows 10, a perfect development environment for Docker use-cases. Here, we will be seeing how to install Docker version 19 in Windows 10 using the Community Edition (CE) since it is a free version. One such benefit of using this edition is that you can install it on your personal system to learn and build applications around it. However, knowledge of using Docker is crucial, if you need to build Cloud Native Microservices based applications.
- Docker only supports: Windows 10 64-bit – Pro, Enterprise, or Education (Build 16299 or later).
- It is to remember that Docker needs Hyper-V enabled in Windows 10, if Hyper-V is not enabled then Docker will not run.
Need to know how to enable Hyper-V, visit the following link docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v. In case, if you use Windows Home, these guidelines will not be applicable.
Step 1: Downloading Docker:
You can install the Docker desktop using Github or official Docker site. Here, we will go with the official site https://docs.docker.com/docker-for-windows/install/
In case, if you want to install the stable version, then click Get Stable and similarly, If you want an Edge version, then you can click on Get Edge. Here we will go with the Stable Version.
Stable Channel: Stable is the best channel to use if you want a reliable platform to work with. You can select whether to send usage statistics and other data. Launched once every quarter, the stable releases help to track the Docker platform’s stable releases.
Edge Channel: Use the Edge channel if you want to get experimental features faster, and get away from bugs and instability. The Edge releases also collect the usage data.
Step 2: Installing Docker
Soon after downloading, locate the downloaded file or open the Downloads folder. Lets run the exec file of docker desktop application.
As a next step, it will download all the necessary files, and to your notice, if you’re not connected to the internet, this particular step will be skipped.
Step 3: Configuration
Post downloading the required files, it is time to proceed with the configuration part. As you can see in the below image, we have checked both the options in the dialog box, you can check/uncheck as per your requirements.
Note: Just to remember, if you have not enabled Hyper-V yet, you can enable it now.
Now the Docker Hub will extract the packages which have been downloaded in the previous step, and wait till the installation completes.
Next, close the installation wizard and restart the Docker desktop.
Step 4: Running the Docker Hub
Open the Docker Hub application. The below shown is the dashboard before you log in to the Docker desktop application.
Login using the Docker Hub credentials.
Note: if you don’t have the Docker Hub account, please find the following link for signup https://hub.docker.com/
By default, Docker will get started on system startup. If you don’t want to start Docker Hub on starting, do the following steps.
Step 5: Running simple Docker image
Check Docker version using the Windows command prompt.
Lets work with simple docker images
Download “hello world” image
Download “Nginx” image
Note: If you don’t have the images, the Docker will pull it from the Docker Hub. If you already have the images in local, it directly starts running.
i) Checking Docker image and container status using cmd
To check the docker images using cmd, type:
To check the Docker container status using cmd, type:
Note: To know more about the Docker commands, visit Managing Docker Commands
ii) Checking Docker image and container status using Docker Hub
Let’s open the Docker desktop application
Let’s see the hello world image
Let’s see the Nginx image
Step 6: Verification
To add domain to etc hosts, open the etc host file using the following command.
Default Nginx Welcome Page
Note: Make sure that you use either localhost ip address or container’s ip address.
- CPU – If your CPU does not support virtualization, or if you do not have a 64-bit CPU, you cannot run Docker locally.
- Operating System – If you do not run a 64-bit version of Windows 10 Pro, Enterprise, or Education; 1511 November update, Build 10586 or later, you cannot run Docker for Windows.
- RAM – Docker consumes more RAM. Using Docker on 8 GB RAM leads to performance issues. Though it still works and does not create any major problems on 8 GB RAM, 16 GB RAM is the ideal option to go with.
Note: You need at least 8 GB RAM minimum, if it is 16 GB will be more than sufficient (maximum).
The article started off with the guidelines to install Docker Toolbox and Docker Desktop for the latest versions of Windows took you through the steps of installing Docker on Windows 10. We come across fulfilling all the necessary Docker requirements, running the simple Docker image and checking both the docker image and container status using cmd and Docker Hub. Want to use Docker on Ubuntu, read our blog post on How to Install Docker on Ubuntu 18.04 As additional information, we also learnt the most common pitfalls to be avoided and thereby sticking with the best practices for optimum performance.
Estimated reading time: 9 minutes
Update to the Docker Desktop terms
Professional use of Docker Desktop in large organizations (more than 250 employees or more than $10 million in revenue) requires users to have a paid Docker subscription. While the effective date of these terms is August 31, 2021, there is a grace period until January 31, 2022, for those that require a paid subscription. For more information, see Docker Desktop License Agreement.
Welcome to Docker Desktop for Windows. This page contains information about Docker Desktop for Windows system requirements, download URL, instructions to install and update Docker Desktop for Windows.
Download Docker Desktop for Windows
Your Windows machine must meet the following requirements to successfully install Docker Desktop.
WSL 2 backend
- Windows 10 64-bit: Home or Pro 2004 (build 19041) or higher, or Enterprise or Education 1909 (build 18363) or higher.
- Enable the WSL 2 feature on Windows. For detailed instructions, refer to the Microsoft documentation.
The following hardware prerequisites are required to successfully runWSL 2 on Windows 10:
- 64-bit processor with Second Level Address Translation (SLAT)
- 4GB system RAM
- BIOS-level hardware virtualization support must be enabled in theBIOS settings. For more information, seeVirtualization.
- Download and install the Linux kernel update package.
Hyper-V backend and Windows containers
Windows 10 64-bit: Pro 2004 (build 19041) or higher, or Enterprise or Education 1909 (build 18363) or higher.
For Windows 10 Home, see System requirements for WSL 2 backend.
- Hyper-V and Containers Windows features must be enabled.
The following hardware prerequisites are required to successfully run ClientHyper-V on Windows 10:
- 64 bit processor with Second Level Address Translation (SLAT)
- 4GB system RAM
- BIOS-level hardware virtualization support must be enabled in theBIOS settings. For more information, seeVirtualization.
Docker only supports Docker Desktop on Windows for those versions of Windows 10 that are still within Microsoft’s servicing timeline.
Containers and images created with Docker Desktop are shared between alluser accounts on machines where it is installed. This is because all Windowsaccounts use the same VM to build and run containers. Note that it is not possible to share containers and images between user accounts when using the Docker Desktop WSL 2 backend.
Nested virtualization scenarios, such as running Docker Desktop on aVMWare or Parallels instance might work, but there are no guarantees. Formore information, see Running Docker Desktop in nested virtualization scenarios.
About Windows containers
Looking for information on using Windows containers?
- Switch between Windows and Linux containersdescribes how you can toggle between Linux and Windows containers in Docker Desktop and points you to the tutorial mentioned above.
- Getting Started with Windows Containers (Lab)provides a tutorial on how to set up and run Windows containers on Windows 10, Windows Server 2016 and Windows Server 2019. It shows you how to use a MusicStore applicationwith Windows containers.
- Docker Container Platform for Windows articles and blogposts on the Docker website.
Install Docker Desktop on Windows
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. It typically downloads to your
Downloadsfolder, or you can run it from the recent downloads bar at the bottom of your web browser.
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.
Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
When the installation is successful, click Close to complete the installation process.
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
Docker Desktop does not start automatically after installation. To start Docker Desktop:
Search for Docker, and select Docker Desktop in the search results.
Here’s a summary of the key changes:
- It remains free for small businesses (fewer than 250 employees AND less than $10 million in revenue), personal use, education, and non-commercial open source projects.
- It requires a paid subscription for professional use in larger enterprises.
- The effective date of these terms is August 31, 2021. There is a grace period until January 31, 2022 for those that will require a paid subscription to use Docker Desktop.
- The existing Docker Free subscription has been renamed Docker Personal and we have introduced a Docker Business subscription .
- The Docker Pro, Team, and Business subscriptions include commercial use of Docker Desktop.
Click the checkbox to indicate that you accept the updated terms and then click Accept to continue. Docker Desktop starts after you accept the terms.
If you do not agree to the updated terms, the Docker Desktop application will close and you can no longer run Docker Desktop on your machine. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see Docker Desktop License Agreement. We recommend that you also read the Blog and FAQs to learn how companies using Docker Desktop may be affected.
Quick Start Guide
When the initialization is complete, Docker Desktop launches the Quick Start Guide. This tutorial includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
To run the Quick Start Guide on demand, right-click the Docker icon in the Notifications area (or System tray) to open the Docker Desktop menu and then select Quick Start Guide.
Congratulations! You are now successfully running Docker Desktop on Windows.
When an update is available, Docker Desktop displays an icon to indicate the availability of a newer version.
Starting with Docker Desktop 4.1.0, the Software Updates section in the General tab also notifies you of any updates available to Docker Desktop. You can choose to download the update right away, or click the Release Notes option to learn what’s included in the updated version. If you are on a Docker Team or a Business subscription, you can turn off the check for updates by clearing the Automatically Check for Updates checkbox in the General settings. This will also disable the notification badge that appears on the Docker Dashboard.
To encourage developers to stay up to date, Docker Desktop displays a reminder two weeks after an update becomes available. You can dismiss this daily reminder by clicking Snooze. You can skip an update when a reminder appears by clicking the Skip this update option.
Docker Subscription Service Agreement
Beginning on August 31, 2021, you must agree to the Docker Subscription Service Agreement to continue using Docker Desktop. Read the Blog and the Docker subscription FAQs to learn more about the changes.
Click Download update When you are ready to download the update. This downloads the update in the background. After downloading the update, click Update and restart from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
When Docker Desktop starts, it displays the Docker Subscription Service Agreement window. Read the information presented on the screen to understand how the changes impact you. Click the checkbox to indicate that you accept the updated terms and then click Accept to continue.
If you do not agree to the terms, the Docker Desktop application will close and you can no longer run Docker Desktop on your machine. You can choose to accept the terms at a later date by opening Docker Desktop.
Docker Desktop starts after you accept the terms.
Uninstall Docker Desktop
To uninstall Docker Desktop from your Windows machine:
- From the Windows Start menu, select Settings > Apps > Apps & features.
- Select Docker Desktop from the Apps & features list and then select Uninstall.
- Click Uninstall to confirm your selection.
Uninstalling Docker Desktop destroys Docker containers, images, volumes, andother Docker related data local to the machine, and removes the files generatedby the application. Refer to the back up and restore datasection to learn how to preserve important data before uninstalling.
Where to go next
- Getting started introduces Docker Desktop for Windows.
- Get started with Docker is a tutorial that teaches you how todeploy a multi-service stack.
- Troubleshooting describes common problems, workarounds, andhow to get support.
- FAQs provide answers to frequently asked questions.
- Release notes lists component updates, new features, and improvements associated with Docker Desktop releases.
- Back up and restore data provides instructions on backing up and restoring data related to Docker.