Estimated reading time: 6 minutes
- Nov 18, 2020 Congratulations, Docker Installation on Windows is now done, and now, you are ready to build and run Docker images and containers on the Docker ecosystem. Uninstall Docker Desktop Tool Suppose you want to uninstall Docker Desktop from your Windows Home machine, follow the steps mentioned below.
- Install Docker Toolbox in Windows For Windows 7 (and higher) users, Docker provides Docker Toolbox, an installer that includes everything needed to configure and launch a Docker environment. Docker Toolbox allows you to deploy development containers in legacy Windows systems that do not meet the requirements of the new Docker for Windows.
C: choco install docker-machine Using Git Bash terminal, use Docker Machine to install Docker Engine. This will download a Linux image containing the Docker Engine and have it run as a VM using.
Docker Desktop for Windows is the Community version of Docker for Microsoft Windows.You can download Docker Desktop for Windows from Docker Hub.
By downloading Docker Desktop, you agree to the terms of the Docker Software End User License Agreement and the Docker Data Processing Agreement.
System requirements
Your Windows machine must meet the following requirements to successfully install Docker Desktop.
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.
- 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.
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.
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.
Note
Docker supports Docker Desktop on Windows for those versions of Windows 10 that are still within Microsoft’s servicing timeline.
What’s included in the installer
The Docker Desktop installation includes Docker Engine,Docker CLI client, Docker Compose,Notary,Kubernetes,and Credential Helper.
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 yourDownloads
folder, 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.
When the whale icon in the status bar stays steady, Docker Desktop is up-and-running, and is accessible from any terminal window.
If the whale icon is hidden in the Notifications area, click the up arrow on thetaskbar to show it. To learn more, see Docker Settings.
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.
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.
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 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.
Important
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.
Why Docker?
Docker is an open platform that can be used to deploy applications in isolated, secure containers. Docker containers are lightweight, simple to configure and work consistently in diverse IT environments. Most Bitnami applications are available as Docker containers and offer all the usual Bitnami benefits: security, optimization, consistency and frequent updates.
Install Docker Toolbox in Windows
For Windows 7 (and higher) users, Docker provides Docker Toolbox, an installer that includes everything needed to configure and launch a Docker environment. Docker Toolbox allows you to deploy development containers in legacy Windows systems that do not meet the requirements of the new Docker for Windows application.
Docker Toolbox contains the following tools:
- Docker Machine
- Docker Engine
- Docker Compose
- Kinematic
- Docker Quickstart Terminal App
- Oracle VirtualBox
Prerequisites
Your Windows system must meet the following minimum requirements:
- 64-bit Windows 7 (or higher)
- Virtualization enabled
Step 1: Check system configuration
The first step is to check if your system configuration meets the requirements needed for running the installer successfully.
Check Windows version
Install Docker-machine Windows Server 2016
Docker Toolbox requires 64-bit Windows 7 (or higher). There are many ways to verify if your machine meets these requirements.
Check OS version in Windows 10
- Type “Settings” in the Windows Search Box and select “System -> About”.
- Find your Edition and Version under your PC name.
- Look “System type” to check if you are running a 32-bit or 64-bit version of Windows.
Check OS version in Windows 7 and 8
- Go to “Control Panel -> System and Security -> System”. Check the Windows Edition and System Type.
Docker Machine Install Windows 7
Find more information about how to check your Windows operating system.
Enable hardware-assisted virtualization
Enabling hardware-assisted virtualization is mandatory for installing Docker Toolbox.
Hardware-assisted virtualization in Windows 8 or higher
You can check if your system supports this technology in two different ways.
Using the Windows Task Manager:
- Type “Task Manager” in the Windows Search Box.
- Click “Performance” tab. Look under “CPU” to find out if virtualization is enabled or not.
Using the Windows Command Prompt:
Type “Command Prompt” in the Windows Search Box.
Right-click to open the options menu. Select “Run as administrator”.
Navigate to the C: drive by typing:
Run the following command:
NOTE: If virtualization is not enabled in your machine, please check how to enable it in your BIOS by following your manufacturer’s instructions.
Hardware-assisted virtualization in Windows 7
- Download and run the Microsoft Hardware-Assisted Virtualization Detection Tool.
Step 2: Install Docker Toolbox
Download Docker Toolbox
Once the system requirements have been verified, download the installer from the Docker website. Click the download button with the Windows logo.
NOTE: Make sure that you are installing the latest release of Docker Toolbox. Find the list of releases in Docker’s GitHub repository.
Docker Toolbox will install the following applications:
- Docker Client for Windows
- Docker Toolbox management tool and ISO
- Oracle VirtualBox
- Git MSYS-git UNIX tools
Launch the Docker Toolbox setup wizard
IMPORTANT: If you have VirtualBox installed and running, please shut down it before the installation begins.
These are the steps you must follow for completing the Docker Toolbox installation:
Open the installer by double-clicking the .exe file. Choose “Yes” in the Windows security dialog box to allow the program to make changes to your PC.
When the Docker Toolbox setup wizard starts, click the “Next” button.
Choose the local folder for Docker Toolbox installation. Click the “Next” button.
Check the components to be installed (“Git for Windows” is recommended; uncheck “VirtualBox” if already installed). Click “Next”.
Accept all default options and click the “Next” button.
Verify that all selected components will be installed. Click “Back” to change any settings.
Click the “Install” button to finish the installation. If Windows should ask you about permitting changes to your PC, click “Yes” to allow it to make the necessary changes.
After all the components are installed, the wizard will notify that installation was successful. Uncheck “View Shortcuts in File Explorer” and click “Finish”.
Step 3: Verify the installation
To verify installation, follow these steps:
Go to your desktop, which should have these three icons:
- Docker Quickstart Terminal
- Kitematic
- Oracle VM VirtualBox.
Launch the Docker Quickstart Terminal by clicking the corresponding icon. This starts the creation of the Docker machine and all its components.
Click near the $ symbol to activate the terminal.
Type the following command and press Enter:
Docker will download and run the “Hello world” container. A confirmation message will be displayed in the terminal.
This indicates that your Docker installation is successful.
Step 4: Run Bitnami WordPress in Docker
Now that Docker is running, the next step is to use it with a Bitnami application. This guide will use the Bitnami WordPress Docker image.
The Bitnami WordPress Docker image provides the latest version of WordPress, including recent updates.This image deploys two containers, one for the database and another for the application itself.
Follow the steps below to deploy the Bitnami WordPress image:
Open the Docker Quickstart Terminal by double-clicking the icon.
Browse to Bitnami’s Docker image for WordPress. Click the “Clone or download” button. Copy the URL to the clipboard.
Type git clone in the Docker Quickstart Terminal and paste the URL:
Check the IP address of your Docker machine by executing the following command:
Change the directory:
Run the docker-compose up command to launch the containers and to create the volumes:
Access the application by browsing to the Docker machine IP address. You should see something like this: