Windows 10 On Docker

/ Comments off
  • I've reading docker API and trying to create a simple container and expose 1 port. In my example, I have an application that listen on TCP port 9595 inside the container and I want to access it from outside world (i.e. The host of the container) on port 9090.
  • Note: A 64-bit processor and 4GB system RAM are the hardware prerequisites required to successfully run Docker on Windows 10. Then, double-click on the Docker.
  • Build and Run Your First Windows Server Container (Blog Post) gives a quick tour of how to build and run native Docker Windows containers on Windows 10 and Windows Server 2016 evaluation releases. Getting Started with Windows Containers (Lab) shows you how to use the MusicStore application with Windows containers.
  • The Docker team recommends that you avoid mounting from the Windows 10 file system (even on a WSL distro). For example, avoid docker run -v /mnt/c/users:/users and use docker run -v /my-project:/sources instead.

March 2, 2020 by Matt Hernandez, @fiveisprime

The official Windows base image for containers.

Last June, the Docker team announced that they will be investing in getting Docker running with the Windows Subsystem for Linux (WSL). All of this is made possible with the recent changes to the architecture of WSL to run within a lightweight virtual machine (VM), which we talked about in an earlier blog post about WSL 2. Since this announcement, the Docker team has released a Technical Preview of Docker that includes support for running with WSL 2.

This article explains how the Docker Desktop technical preview works as well as how to use the Docker extension with the technical preview.

How it works

This new Docker architecture works a lot like Visual Studio Code's WSL remote development support in that the Docker CLI running on the host machine executes commands within the Docker Integration Package, which runs on the remote WSL VM.

Image credit: Docker Engineering

DockerD runs directly within WSL so there's no need for the Hyper-V VM and all Linux containers run within the Linux userspace on Windows for improved performance and compatibility.

Getting set up

First some prerequisites:

  • Install Windows 10 Insider Preview build 18975 (Slow) or later for WSL 2.
  • Install Ubuntu from the Microsoft store.
  • Enable WSL 2 by following this guide.
  • Install the Remote - WSL extension for VS Code.
  • Install the Docker WSL 2 Technical Preview.

Once installed, Docker will recognize that you have WSL installed and prompt to enable WSL integration. You want to Enable WSL integration for this tutorial.

This option will allow you to access Docker Desktop via the Docker CLI directly from within your Linux distro.

If you have multiple Linux distros, make sure you only have WSL integration turned on for the correct one in your Docker settings:

With that configured, all commands will execute in the Linux context - this includes Docker commands run from PowerShell so running something like docker run mongo… will start a Linux container within the WSL VM.

Running the docker ps command over in WSL, you'll see the container as expected. Notice that the container ID matches.

Using VS Code

With this set up and running, you can install the VS Code Docker extension and access your containers. If you're already running WSL 2 and the Remote - WSL extension, this will help you get Docker integrated into your WSL workflow rather than switching contexts when you need containers. And because the Docker CLI's context is set to use DockerD in WSL, the extension will work with your containers regardless of whether you opened VS Code using the Remote - WSL extension.

Notice how in the screenshot below, I'm connected and working in WSL and still building/running containers without changing from my preferred environment (zsh in Ubuntu).

Theme: Noctis Sereno

I've personally noticed a vast improvement in container execution times using this configuration and each part of my typical development workflow remains the same. I'm also using the Remote - Containers extension within WSL for testing specific environments without setting things up directly on my machine.

We want your feedback

Keep in mind that you're using prerelease software and, while the Windows Insiders Slow ring is very stable, you may run into some issues. If you do find something that isn't working as expected, please open an issue via the Feedback tool in Windows. Any direct Docker issues or feedback can be logged in the Docker for Windows repo.

Happy Coding!

Matt Hernandez, VS Code Program Manager @fiveisprime

Estimated reading time: 30 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.

This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases.

Docker Desktop 4.1.0

2021-09-30

Download Docker Desktop

New

Software Updates: The Settings tab now includes a new section to help you manage Docker Desktop updates. The Software Updates section notifies you whenever there’s a new update and allows you to download the update or view information on what’s included in the newer version. For more information, see Software Updates.

Compose V2 You can now specify whether to use Docker Compose V2 in the General settings.

Volume Management: Volume management is now available for users on any subscription, including Docker Personal. For more information, see Explore volumes.

Upgrades

  • Base distro to debian:bullseye

Bug fixes and minor changes

  • Fixed a bug related to anti-malware software triggering, self-diagnose avoids calling the net.exe utility.
  • Fixed filesystem corruption in the WSL 2 Linux VM in self-diagnose. This can be caused by microsoft/WSL#5895.
  • Fixed SeSecurityPrivilege requirement issue. See docker/for-win#12037.
  • Fixed CLI context switch sync with UI. See docker/for-win#11721.
  • Added the key vpnKitMaxPortIdleTime to settings.json to allow the idle network connection timeout to be disabled or extended.
  • Fixed a crash on exit. See docker/for-win#12128.
  • Fixed a bug where the CLI tools would not be available in WSL 2 distros.
  • Fixed switching from Linux to Windows containers that was stuck because access rights on panic.log. See for-win#11899.

Known Issue

Docker Desktop may fail to start when upgrading to 4.1.0 on some WSL-based distributions such as ArchWSL. See docker/for-win#12229

Docker Desktop 4.0.1

2021-09-13

Download Docker Desktop

Upgrades

  • Compose V2 RC3
    • Compose v2 is now hosted on github.com/docker/compose.
    • Fixed go panic on downscale using compose up --scale.
    • Fixed a race condition in compose run --rm while capturing exit code.

Bug fixes and minor changes

  • Fixed a bug where Docker Desktop would not start correctly with the Hyper-V engine. See docker/for-win#11963
  • Fixed a bug where copy-paste was not available in the Docker Dashboard.

Docker Desktop 4.0.0

2021-08-31

Download Docker Desktop

New

Docker has announced updates and extensions to the product subscriptions to increase productivity, collaboration, and added security for our developers and businesses.

The updated Docker Subscription Service Agreement includes a change to the terms for Docker Desktop.

  • Docker Desktop remains free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open source projects.
  • It requires a paid subscription (Pro, Team, or Business), for as little as $5 a month, 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 Docker Pro and Docker Team subscriptions now include commercial use of Docker Desktop.
  • The existing Docker Free subscription has been renamed Docker Personal.
  • No changes to Docker Engine or any other upstream open source Docker or Moby project.

    To understand how these changes affect you, read the FAQs. For more information, see Docker subscription overview.

Upgrades

  • Compose V2 RC2
    • Fixed project name to be case-insensitive for compose down. See docker/compose-cli#2023
    • Fixed non-normalized project name.
    • Fixed port merging on partial reference.

Bug fixes and minor changes

  • Fixed a bug where the CLI tools would not be available in WSL 2 distros.
  • Fixed a bug when switching from Linux to Windows containers due to access rights on panic.log. for-win#11899

Docker Desktop 3.6.0

2021-08-11

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

  • Dev Environments: You can now create a Dev Environment from your local Git repository. For more information, see Start a Dev Environment from a local folder.
  • Volume Management: You can now sort volumes by the name, the date created, and the size of the volume. You can also search for specific volumes using the Search field. For more information, see Explore volumes.

Upgrades

  • Compose V2 RC1
    • Docker compose command line completion.
    • Allow setting 0 scale/replicas.
    • Detect new container on logs —follow.

Bug fixes and minor changes

  • Update kernel configuration to fix a performance regression in Docker Desktop 3.0.0that caused publishing container ports to take 10 times longer than on olderversions. For more information, see linuxkit/linuxkit#3701and docker/for-mac#5668.
  • Fixed a bug where the DNS server would fail after receiving an unexpectedly large datagram.
  • Fixed spurious traces on iptables updates.
  • Fixed slowness when adding multiple ports forwarding option.
  • Fixed bug where the WSL 2 synchonization code creates dangling symlinks if the WSL 2 home directory if it is the same as the Windows home directory. Fixes docker/for-win#11668.
  • Fixed docker context ls after upgrade from 3.5.x when the Linux WSL 2 home directory is the same as the Windows home directory.
  • Fixed the permissions on %PROGRAMDATA%Docker to avoid a potential Windows containers compromise. See CVE-2021-37841. Thanks to Alessio Dalla Piazza for discovering the issue and to @kevpar for helpful discussion.
  • Fixed bug where the Linux home directory under WSL 2 was set to the Windows home directory e.g. /mnt/c/Users/....
  • Fixed bug where Desktop would fail to start if it could not parse CLI contexts. Fixes docker/for-win#11601.
  • Fixed an issue related to log display inside a container docker/for-win#11251.
  • Fixed failures of the Windows Background Intelligent Transfer Service preventing Docker Desktop to start. docker/for-win#11273

Docker Desktop 3.5.2

2021-07-08

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Upgrades

  • Compose V2 beta 6
    • compose run and compose exec commands use separate streams for stdout and stderr. See docker/compose-cli#1873.
    • compose run and compose exec commands support detach keys. Fixes docker/compose-cli#1709.
    • Fixed --force and --volumes flags on compose rm command. See docker/compose-cli#1844.
    • Fixed network’s IPAM configuration. Service can define a fixed IP. Fixes for docker/compose-cli#1678 and docker/compose-cli#1816
  • Dev Environments
    • Support VS Code Insiders. See dev-environments#3
    • Allow users to specify a branch when cloning a project. See dev-environments#11

Bug fixes and minor changes

  • Dev Environments: Fixed a blank screen in some create and remove scenarios. Fixes dev-environments#4
  • Dev Environments: Fixed error handling when removing an environment. Fixes dev-environments#8
  • Dev Environments: The Start, Stop, and Share buttons are disabled while an environment is being created or removed.
  • Do not automatically switch CLI contexts on application start or when switching between Windows and Linux containers. Fixes docker/for-mac#5787 and docker/for-win#11530.
  • Fixed spurious traces on iptables updates.
  • Fixed a delay when adding a multiple port forwarding option.

Docker Desktop 3.5.1

Windows 10 On Docker

Windows 10 Docker On Ubuntu

2021-06-25

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Bug fixes and minor changes

  • Fixed a bug where users could not install Docker Desktop when the path to the temp folder contained dots. Fixes docker/for-win#11514
  • Fixed a link to the policy that provides details on how Docker handles the uploaded diagnostics data. Fixes docker/for-mac#5741

Docker Desktop 3.5.0

2021-06-23

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Upgrades

  • Compose V2 beta
    • Fixed a bug where a container cannot be started when a file is bind-mounted into a nested mountpoint. Fixes docker/compose-cli#1795.
    • Added support for container links and external links.
    • Introduced the docker compose logs --since --until option.
    • docker compose config --profiles now lists all defined profiles.
  • From Kubernetes 1.21.1 to Kubernetes 1.21.2

Bug fixes and minor changes

  • Volume Management
    • Users can now remove a file or directory inside a volume using the the Docker Dashboard.
    • The Volumes view in Docker Dashboard displays the last modified time and the size of the contents inside a volume.
    • Users can save the files and directories inside a volume from Docker Dashboard.
  • Fixed an issue that caused credStore timeout errors when running the docker login command. Fixes docker/for-win#11472
  • Docker Desktop now allows the WSL 2 integration agent to start even when /etc/wsl.conf is malformed.
  • Fixed an issue with the Docker Compose app not being stopped or removed when started by multiple configuration files. docker/for-win#11445
  • Fixed a bug where Docker Desktop fails to restart after a power failure because the Hyper-V VM restarted prematurely.
  • The default docker CLI context is now desktop-linux in Linux containers mode and desktop-windows when in Windows containers mode.
  • Show the Docker Desktop Feedback popup only when clicking Docker menu.

Docker Desktop 3.4.0

2021-06-09

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

Volume Management: Docker Desktop users can now create and delete volumes using the Docker Dashboard and also see which volumes are being used. For more information, see Explore volumes.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Skip Docker Desktop updates: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see Docker Desktop updates.

Deprecation

  • Docker Desktop no longer installs Notary, docker trust should be used for image signing.

Upgrades

Bug fixes and minor changes

  • Fixed error showing stderr log in the UI. Fixes docker/for-win#11251.
  • Automatically reclaim space after deleting containers by deleting volumes and removing build cache.
  • Docker Compose applications with file names other than docker-compose.yml can now be removed from Docker Desktop. Fixes docker/for-win#11046
  • Fixed version number missing in update dialog window.
  • Fixed an issue where the diagnostics were sometimes not uploaded correctly from the Support dialog.
  • Fixed DNS entries for *.docker.internal and Kubernetes cluster reset after the VM IP changes.
  • Fixed a corrupted internal cache which was preventing Docker Desktop from starting. Fixes docker/for-win#8748.
  • Fixed an issue where docker info sometimes took longer to respond. Fixes docker/for-win#10675

Docker Desktop 3.3.3

2021-05-06

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Upgrades

Bug fixes and minor changes

  • Fixed the diagnostics failing to upload from the Troubleshoot screen.

Docker Desktop 3.3.2

2021-05-03

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Upgrades

Bug fixes and minor changes

  • Fixed a bug where a metrics-port defined in the engine’s daemon.json blocks application restart.
  • Fixed a leak of ephemeral ports. Fixes docker/for-mac#5611.
  • Enable buildkit garbage collection by default.
  • Fixed a bug which blocked binding to port 123. Fixes docker/for-mac#5589.
  • Removed the “Deploy Docker Stacks to Kubernetes by default” Kubernetes setting. The component was removed in 2.4.0.0 but we forgot to remove the setting. Fixes docker/for-mac#4966.

Docker Desktop 3.3.1

2021-04-15

Windows 10 On Docker Command

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Bug fixes and minor changes

  • Docker Desktop now ensures the permissions of /dev/null and other devices are correctly set to 0666 (rw-rw-rw-) inside --privileged containers. Fixes docker/for-mac#5527.
  • Fixed an issue that caused docker run to fail when using wsl.localhost path to a directory. Fixes docker/for-win#10786
  • Fixed an issue that caused Docker Desktop to fail during startup when it is unable to establish a connection with Docker Hub in the backend. Fixes docker/for-win#10896
  • Fixed file permission when creating a file from a delta update. Fixes docker/for-win#10881

Docker Desktop 3.3.0

2021-04-08

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

You can now specify when to download and install a Docker Desktop update. When an update becomes available, Docker Desktop displays an icon to indicate the availability of a newer version. You can download the update in the background whenever convenient. When the download is complete, all you need to do is to click Update and restart to install the latest update.

Developers who use Docker Desktop for professional development purposes may at times need to skip a specific update. For this reason, users with a paid Docker subscription can skip notifications for a particular update when a reminder appears.

For developers in IT managed environments, who don’t have administrative access to install updates to Docker Desktop, there is now an option in the Settings menu to opt out of notifications altogether for Docker Desktop updates if your Docker ID is part of a Team subscription.

Upgrades

Bug fixes and minor changes

  • Fixed an issue when viewing compose applications that have been started with an explicit project name. Fixes docker/for-win#10564.
  • Ensure --add-host host.docker.internal:host-gateway causes host.docker.internal resolves to the host IP, rather than the IP of the IP router. See docker/for-linux#264.
  • Fixed port allocation for Windows containers. Fixes docker/for-win#10552.
  • Fixed an issue where running a container with a random port on the host caused Docker Desktop dashboard to incorrectly open a browser with port 0, instead of using the allocated port.
  • Fixed an issue where pulling an image from Docker Hub using the Docker Desktop dashboard was failing silently.
  • Perform a filesystem check when starting the Linux VM.

Docker Desktop 3.2.2

2021-03-15

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Bug fixes and minor changes

  • Fixed an issue that stopped containers binding to port 53. Fixes docker/for-win#10601.
  • Fixed an issue that 32-bit Intel binaries were emulated on Intel CPUs. Fixes docker/for-win#10594.
  • Fixed an issue related to high CPU consumption and frozen UI when the network connection is lost. Fixes for-win/#10563.

Docker Desktop 3.2.1

2021-03-05

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Upgrades

Docker Desktop 3.2.0

2021-03-01

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

  • The Docker Dashboard opens automatically when you start Docker Desktop.
  • The Docker Dashboard displays a tip once a week.
  • BuildKit is now the default builder for all users, not just for new installations. To turn this setting off, go to Settings > Docker Engine and add the following block to the Docker daemon configuration file:

Upgrades

Deprecation

  • Docker Desktop cannot be installed on Windows 1709 (build 16299) anymore.
  • Removed the deprecated DNS name docker.for.win.localhost. Use DNS name host.docker.internal in a container to access services that are running on the host. docker/for-win#10619

Bug fixes and minor changes

  • Fixed an issue on the container detail screen where the buttons would disappear when scrolling the logs. Fixes docker/for-win#10160
  • Fixed an issue when port forwarding multiple ports with an IPv6 container network. Fixes docker/for-mac#5247
  • Fixed a regression where docker load could not use an xz archive anymore. Fixes docker/for-win#10364
  • Fixed an issue that caused the WSL 2 backend shutdown process to interfere with Windows shutdown. Fixes docker/for-win#5825docker/for-win#6933docker/for-win#6446
  • Fixed creds store using desktop.exe from WSL 2. Fixes docker/compose-cli#1181
  • Fixed a navigation issue in the Containers / Apps view. Fixes docker/for-win#10160
  • Fixed container instance view with long container/image name. Fixes docker/for-win#10160
  • Fixed an issue when binding ports on specific IPs. Note: It may now take a bit of time before the docker inspect command shows the open ports. Fixes docker/for-win#10008
  • Fixed an issue where an image deleted from the Docker dashboard was still displayed on the Images view.

Docker Desktop 3.1.0

2021-01-14

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

  • Add experimental support for GPU workloads with WSL 2 backend (requires Windows Insider developer channel).
  • Docker daemon now runs within a Debian Buster based container (instead of Alpine).

Upgrades

Bug fixes and minor changes

  • Fixed an issue where disabling proxy settings would not work. Fixes docker/for-win#9357.
  • Fixed UI reliability issues when users create or delete a lot of objects in batches.
  • Redesigned the Support UI to improve usability.

Docker Desktop 3.0.4

2021-01-06

Windows 10 On Docker Linux

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Upgrades

Bug fixes and minor changes

  • Fixed an issue that could cause Docker Desktop to fail to start after upgrading to 3.0.0. Fixes docker/for-win#9755.

Docker Desktop 3.0.0

2020-12-10

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

New

  • Use of three-digit version number for Docker Desktop releases.
  • Docker Desktop updates are now much smaller as they will be applied using delta patches. For more information, see Automatic updates.
  • First version of docker compose (as an alternative to the existing docker-compose). Supports some basic commands but not the complete functionality of docker-compose yet.

    • Supports the following subcommands: up, down, logs, build, pull, push, ls, ps
    • Supports basic volumes, bind mounts, networks, and environment variables

      Let us know your feedback by creating an issue in the compose-cli GitHub repository.

Upgrades

Bug fixes and minor changes

  • Downgraded the kernel to 4.19.121 to reduce the CPU usage of hyperkit. Fixes docker/for-mac#5044
  • Fixed an unexpected EOF error when trying to start a non-existing container with -v /var/run/docker.sock:. See docker/for-mac#5025.

Known issues

  • Building an image with BuildKit from a git URL fails when using the form github.com/org/repo. To work around this issue, use the form git://github.com/org/repo.
  • Some DNS addresses fail to resolve within containers based on Alpine Linux 3.13.

We've updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected.

Windows 10 On Docker

By clicking 'Accept and Download', you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

Windows 10 Docker Desktop Not Starting

Docker Desktop for Windows, release notes