Upgrade Docker Mac

Posted : admin On 12.08.2021
  • Minikube docker-env. This would print some global variables required to start the docker daemon. If you are on Linux or Mac then you can run eval $(minikube docker-env) command to make those settings. But eval command doesn’t work on windows. On windows, the equivalent command is, @FOR /f 'tokens=.'%i IN ('minikube -p minikube docker-env.
  • All open source functionality can be used free with the option to upgrade to the full paid Enterprise feature set, including support for Enterprise plugins. Linux Windows Mac Docker ARM Docker (Alpine base image).
  1. Upgrade Docker Centos
  2. Upgrade Docker Compose Windows

What’s Changed Since the Tech Preview

Docker 17.05 extends Dockerfile syntax to support new multi-stage build, by extending two commands: FROM and COPY. The multi-stage build allows using multiple FROM commands in the same Dockerfile. The last FROM command produces the final Docker image, all other images are intermediate images (no final Docker image is produced, but all layers.

Earlier this year, we released a technical preview of our vision for the future of Docker development on Windows using WSL 2. We received lots of feedback from Windows Insiders via different channels, and collated common failure cases. We also used it ourselves a lot, and took the time to evaluate its architecture.

Based on this analysis, we worked hard to redesign Docker Desktop’s WSL2 integration in a more robust and easier to maintain way, while ensuring we get feature parity with what we have today with our Hyper-V backend.

What is new?

Before digging into the details of the new backend architecture, let us see what new features we have:

  1. Kubernetes support: you can now enable Kubernetes when using the WSL 2 backend
  2. Updated daemon: our WSL 2 backend now runs our latest stable Docker Daemon
  3. VPN-friendly networking: our WSL 2 backend leverages our efforts in this area, using vpnkit to ensure a VPN-friendly networking stack
  4. And more: the WSL 2 backend is now at feature parity with our Hyper-V backend. HTTP proxy settings, trusted CA synchronization, version pack support, support for our new container UI…

This new backend can be enabled in Docker Desktop settings:

Once WSL 2 is generally available, we will remove this checkbox, and automatically switch on the WSL 2 backend on compatible machines.

Introducing our new architecture

Based on our users feedback, and on the requirements we identified internally, there are 3 major aspects that we wanted to change in the WSL integration architecture:

  • Run in an isolated environment: we want to run in a separate network/pid/mount namespace, to avoid as much as possible side effects from other applications running on WSL2
  • Leverage our current codebase to avoid re-implementing all the features we already implemented in our own Hyper-V VM
  • Have a complete integration with the existing UI our users are familiar with.

Architecture of the Hyper-V backend

To understand this new architecture, we need to step back a little and look at how the Hyper-V backend is designed, and how the Windows frontend communicates with it.

The most important thing is the Linux VM we run on Hyper-V. This Linux VM is entirely built using LinuxKit which makes it very easy for us to have precise control over everything that runs in it. We wrote a number of LinuxKit components, used both in our Hyper-V and Mac VMs: services controlling the lifecycle of Docker and Kubernetes, services to collect diagnostics in case of failure, services aggregating logs, etc. Those services are packaged in an iso file in the Docker Desktop installation directory (docker-desktop.iso).

On top of this base distro, at runtime we mount a second iso, that we call a version-pack iso. This file contains binaries and deployment / upgrade scripts specific to a version of the Docker Engine and Kubernetes. In Enterprise edition, this second iso is part of the version packs we publish, while in Community, a single version pack is supported (the docker.iso file, also present in the docker desktop installation folder).

Before starting the VM, we also attach a VHD to store container images and configs, as well as the Kubernetes data store.

To make those services reachable from the Windows side, we built a proxy that exposes Unix sockets as Windows named pipes, using Hyper-V Sockets under the hood.

How it translates to the new WSL 2 backend

The new WSL backend design is very close to that, with the difference that we don’t run the LinuxKit distro in a VM but… in a container.

This will create 2 WSL distros for you:

  • Docker-desktop, which I’ll call the bootstrapping distro
  • Docker-desktop-data, which I’ll call the data store distro

From a high level perspective, the bootstrapping distro essentially replaces Hyper-V, while the data store distro replaces the VHD that we previously attached to the VM.

The bootstrapping distro creates a Linux namespace with its own root filesystem based on the same 2 iso files we mentioned earlier (not entirely true, but close enough), and use the data-store distro as the backing store for container images etc. instead of a VHD (WSL 2 does not allow us to attach additional VHD at the moment, so we leverage cross-distro mounts for that). The first iso file is slightly modified from the original one: we have stripped out the Linux Kernel, and the system services provided out of the box by WSL 2. The second one (the version pack iso), is strictly identical to the one we use with Hyper-V (and on Mac as well). The bootstrapping distro also manages things like mounting the Windows 9p shares in a place that can be accessed by the Linuxkit container (to avoid using Samba for sharing Windows files with containers), and controls the lifecycle of the Linuxkit container (ensuring clean shutdown etc.).

This way, Docker runs in a contained environment that is very similar to Hyper-V and MacOS VMs. So close that we actually share the same code base for our Linuxkit components, we very quickly achieved feature parity with Hyper-V backend using the same version pack isos, and the same Windows side code base.

The big difference that this makes is that it starts 15 times quicker than our Hyper-V VM, and thanks to WSL 2 dynamic resource allocations, it can access all the resources of the machine, and consume as little as it really needs. It will make it able to run in environments with lower memory where it was previously difficult to allocate 2GB of the Hyper-V VM upfront.

In a longer term, it also opens the door to supporting Windows versions where Hyper-V is not available but WSL 2 is (Windows Home edition in particular).

Linux Workspaces support

With the tech preview architecture, Linux Workspaces were very easy to implement: the daemon ran in your own distro, so it had direct access to your filesystem. Exposing the daemon worked out of the box as well as bind mounts.

With the new architecture, things are a little bit trickier: we run in a separate distro, and inside an isolated namespace, so how can we achieve the same level of performance?

WSL 2 runs all distros in the same utility VM, sharing the same Kernel. Recently, Microsoft introduced cross-distros bindings, which enables access to the VHD of a given distro from another. Using this we are actually able to expose the daemon to the user distro, and we can access the user distro files from within our contained environment with native Linux performance.

To make bind-mounts a seamless experience, we introduced a docker api proxy similar to the one we use for enabling bind mounts of Windows files that translates paths relative to the user distro into a path to the same file accessible from the LinuxKit container.

Initial limitations

We are still working on polishing the Linux Workspace experience. Initially, you will have to deal with those following limitations:

  1. You can only mounts files backed by your distro VHD (that means you can’t bind mounts things within /tmp, /mnt, /var/run, /proc, /sys etc.). For most people, this should not be a problem, but mounting things like /var/run/docker.sock in a container won’t work initially. We are working with Microsoft on solving this issue, a future Windows Update will bring full bind mount support.
  2. We don’t provide client binaries yet. You need to install the docker cli and plugins using apt, yum or any other package manager on your distro. We will automate this in a later update.

Why did we do that?

When we released the tech preview, what we wanted was to put in the hands of real users, something that represents the vision we have about the future of Linux container development on Windows. We worked very quickly, aside from our main Docker Desktop project to build something we could experiment with, and collected a lot of user feedback (thank you Windows Insiders by the way, this helped a lot!).

We also challenged the tech preview architecture in term of long term concerns such as maintenance costs, problems diagnostics, stability, update handling, code sharing with other backends etc.

We then went back to the whiteboard, designed a few potential alternative architectures, and found that with minimal effort, we would be able to run our LinuxKit VM, with very small modifications, in a container within WSL 2. This approach makes it really easy to implement the same exact mechanisms as we have today for things like problems diagnostics, handling updates, ensuring version pack support, and feature parity with our other backends.

We went to a prototyping phase that proved successful and went on to integrate it directly in our Docker Desktop codebase.

Top issues driving this decision

Users want Kubernetes support

In a larger extent, we want feature parity with the Hyper-V backend. This includes Kubernetes support, of course but also many hidden features like:

  • Version pack support in Enterprise
  • Trusted CA synchronization
  • VPN-friendly networking
  • HTTP proxies support

Our new architecture solve all this.

Docker-compose cannot talk to the WSL 2 engine

The version of docker-compose we shipped with the tech preview was not aware of docker contexts. While we are working on fixing docker-compose, the new architecture makes it easier for client tools not supporting docker context yet to work with (including older versions of docker-compose).

Sometimes containers networking don’t work

We identified several reasons for that, and they are all related to a flaw in our original design: the tech preview runs within your own distro. In this distro you might be running other applications that might deal with network interfaces, iptables, etc. It can create conflicts that are completely outside of our control.

Even worse, all WSL2 distros run in the same network namespace… we have had reports from some users who had issues because they tried to run docker in 2 distros at once. Naturally the 2 Docker daemons killed each other by creating conflicting iptables rules.

Our new architecture is not subject to this issue any more.

Diagnostics are a nightmare

Running within a distro that we don’t control causes huge challenges in terms of problem diagnostics. Especially when adding support for Kubernetes.

There are too many ways the user can break everything, and it is very difficult to create a diagnostics system collecting only non-sensitive data on a system we don’t control. Running within an isolated container solves this issue for us, and we can leverage the same diagnostics services we already use in the Hyper-V and Mac backends.

Supporting more than one “hosting distro” is challenging

Not all our users want to run on Ubuntu, we recognize that and want to give them the choice. However automating installation of the integration package in a really “universal” way is very challenging. By running in our own WSL distro, within a container, we don’t have this issue anymore, and keep the same filesystem performance thanks to cross-distro bind mounts.

Maintenance cost of the integration package is very high

The architecture of the Hyper-V and Mac backends makes it easy for us to share a lot of code. Mac and Windows VMs are almost identical, and we want to keep this great productivity value on WSL 2 as well. The cost of implementing all the features in a new way with the integration package was too high.

Our new approach allows us to share the large majority of our Linux code base between Mac, Hyper-V and WSL 2 backends.

Handling upgrades is very hard

We have extensive experience at handling upgrades with Docker Desktop. It is hard, and we don’t want to duplicate this work.

The new architecture shares the same exact logic as what we have in place for Hyper-V and Mac backends.

Once Microsoft makes WSL 2 generally available, we plan to enable the WSL 2 engine on all supported Windows versions by default. We will still support the Hyper-V backend until Microsoft stops supporting Windows versions without WSL 2 though, but only as a fallback mechanism.

By moving to this “WSL 2 first” approach, we also want to take advantage of its unique characteristics to unlock new features in the future. As an example, WSL 2 is supported on Windows 10 Home. We want to take advantage of that to reach new users in the future (nothing to announce yet, but it is definitely in our backlog).

This new backend paves the way for exciting new features to come, and we are eager to hear your feedback.

We will be releasing the new WSL 2 architecture as part of the next Docker Desktop Edge release. For Windows users already with WSL 2 Download Edge today to get access to the latest Docker architecture in the next couple of weeks.


Developer Community System Requirements Compatibility Distributable Code License Terms Blogs Latest Release Known Issues

Visual Studio 2019 contains many new and exciting features and IDE productivity enhancements tosupport Windows app development, cross-platform mobile development, Azure development, web and cloud development,and more. To try out Visual Studio 2019, see Visual Studio 2019 Downloads.For more information about everything that's new in this release, see theVisual Studio 2019 release notes andWhat's New in Visual Studio 2019.

For Visual Studio Code, see Visual Studio Code FAQ.
For Visual Studio 2019 for Mac, see Visual Studio for Mac Platform Targeting and Compatibility.
For Visual Studio 2019 for Mac release notes.


You can install and use Visual Studio 2019 alongsideprevious versions of Visual Studio, including Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012.


Click a button to download the latest version of Visual Studio 2019. For instructions on installing and updating Visual Studio 2019, see theUpdate Visual Studio 2019 to the most recent release.Also, see instructions on how to install offline.

Note: Installation package size will vary depending on your current Visual Studio configuration. Evernote quick note.

System Requirements

For information on the system requirements for installing and running the Visual Studio 2019 family of products,including Team Foundation Server 2019, see the Visual Studio 2019 System Requirement page andVisual Studio for Mac Product Family System Requirements.

Feedback and Support

For support, or to submit feedback on Visual Studio, see:

Upgrade Projects to Visual Studio 2019

When following the supported upgrade paths, your Visual Studio source, solutions, and project files will continueto work; however, you should expect to make some changes to sources. While we cannot guarantee binary compatibilitybetween releases, we will do our best to document significant changes to assist you with updates.


For details on how to migrate your projects to Visual Studio 2019, see Porting, Migrating, and Upgrading Visual Studio Projects.

Platform Targeting

Visual Studio provides cutting-edge tools and technologies to create apps that take advantage of thelatest platform capabilities, whether Windows, Android, iOS, or Linux. Visual Studio 2019 also targetsearlier platforms so you can create new apps or modernize existing apps that execute on earlier versionsof Windows while leveraging the enhanced development tools, quality enablement, and team collaborationcapabilities in Visual Studio 2019. For more information, see Managing references in aproject and Visual Studio Multi-TargetingOverview.

Visual Studio 2019 Support for Windows Development

The following table explains the Microsoft Windows platforms for which you can build apps by using Visual Studio 2019.

Build Apps that Run on Windows ClientsUsing Tools for Native and Managed Classic Windows Desktop DevelopmentUsing Tools for UWP App Development
Windows 10Yes
(see notes below)
(see notes below)
Windows 10 Team EditionNot applicableYes
(see notes below)
See the Windows Holographic Dev Center.
Xbox OneNot applicableYes
See the Xbox Dev Center.
Windows 8.1 (Windows 8)YesWindows Store app development is not available.
Windows 7YesNot applicable
Windows VistaYes
Remote debugging and profiling tools are not available.
Not applicable
Windows XPYes
Managed development requires using Visual Studio .NET multi-targeting. Remote debugging and profiling tools are not available.
Not applicable
Build Apps that Run on Windows PhoneUsing Tools for Native and Managed Classic Windows Desktop DevelopmentUsing Tools for UWP App Development
Windows 10 MobileNoWindows Store app development is not available.
Windows Phone 8.1 and earlierNoWindows Store app development is not available.
Build Apps that Run on Windows ServerUsing Tools for Native and Managed Classic Windows Desktop DevelopmentUsing Tools for UWP App Development
Windows Server 2016YesYes
(see notes below)
Windows Server 2016, Nano Server Installation OptionYes, for .NET Core and a subset of Win32
See the Nano Server Dev Center.
Windows Server 2012 R2YesWindows Store app development is not available.
Windows Server 2012YesWindows Store app development is not available.
Windows Server 2008 R2YesNot applicable
Windows Server 2008Yes
Remote debugging and profiling tools are not available.
Not applicable
Windows Server 2003Yes
Remote debugging and profiling tools are not available. Managed development requires using Visual Studio .NET multi-targeting and requires side-by-side installation of Visual Studio 2010. For more information, see: A Look Ahead at the Visual Studio 2012 Product Lineup and Platform Support.
Not applicable
Build Apps that Run on Windows Embedded DevicesUsing Tools for Native and Managed Classic Windows Desktop DevelopmentUsing Tools for UWP App Development
Windows 10 IoT CoreYes, for a subset of Win32 APIs
See the IoT Core API Porting Tool for information.
See the Windows IoT Dev Center for additional tools and resources.
Windows 10 IoT Mobile EnterpriseNoYes
See the Windows IoT Dev Center for additional tools and resources.
Windows 10 IoT EnterpriseYes
See the Windows IoT Dev Center for additional tools and resources.
See the Windows IoT Dev Center for additional tools and resources.
Windows Embedded 8 Standard and 8.1 IndustryYesNo
Windows Embedded Compact 2013NoNot applicable
Windows Embedded 7 (Compact, Standard, and POSReady)NoNot applicable
Windows Embedded CE 6.0 and earlierNoNot applicable
Windows XP Embedded (Including POSReady 2009, WES 2009, WEPOS)NoNot applicable


  • For support information regarding Microsoft operating systems, see Microsoft Support Lifecycle and Windows 10 Release Information.
  • For support information on Microsoft .NET Framework, see .NET Framework Support Lifecycle FAQand .NET Framework System Requirements.
  • Windows 10 Enterprise LTSC edition, Windows 10 S and Windows 10 Team Edition are not supported for development.You may use Visual Studio 2019 to build apps that run on Windows 10 LTSC, Windows 10 S and Windows 10 Team Edition. Remote debuging is supported on LTSC.
  • Universal Windows app development for all target platforms is available when Visual Studio is installed on Windows 10.
  • Universal Windows apps can be built from the command line when using Windows Server 2012 R2 or Windows Server 2016. UWP development—includingdesigning, editing, and local debugging—is not available on Windows Server. You may deploy these apps to Windows server and debug them remotely.
  • Unity, and Xamarin can also be used for cross-platform development of Universal Windows Apps on Windows 10.

Visual Studio 2019 Support for .NET Development

Visual Studio 2019 supports development of apps that use any of the .NET implementations. Among the workloads and project types, you can find support for.NET Framework, .NET Core, Mono, .NET Native for Universal Windows Platform (UWP), C#, F#, and Visual Basic. Visual Studio 2019 supports the following .NET implementations:

  • .NET Framework versions 4.8, 4.7.2, 4.7.1, 4.7, 4.6.2, 4.6.1, 4.6, 4.5.2, 4.5.1, 4.5, and 4.0
  • .NET Core 3.1, 3.0, 2.2, 2.1, and 1.1.


For more information on each of these implementations, and on the common API specification .NET Standard, see .NET architectural components.

Visual Studio 2019 Support for Android Development

Visual Studio 2019 enables you to build native Android apps using Xamarin and C# or using C++. The Visual Studio Tools for Unity andthe Unreal Engine enable Android game development. You can also use Visual Studio for Macto build Android apps using a Mac.

You can use Visual Studio setup to easily obtain the Android SDK and Android API levels 19, 21, 22, and 23.You can download additional API levels separately using the Android SDK Manager.You can also use Visual Studio Setup to obtain the Android Native Development Kit (R10E), Java SE Development Kit, and Apache Ant.

For more information, see Android development with Visual Studio andMobile App Development.


For information on .NET development for Android, see .NET architectural components.

Visual Studio 2019 Support for iOS Development

Visual Studio 2019 enables you to build and debug apps for iOS by using C++, Unity, or Xamarinand a Mac configured for iOS development when using remotebuild, vcremote, the Visual Studio Tools for Unity,or the Xamarin Mac Agent. Xamarin supports iOS 7 and higher, and requires OS X 10.10 'Yosemite' or higher.You can also use Visual Studio for Mac to build iOS apps using a Mac.


For more information, see Cross-platform mobile development in Visual Studio.For information on .NET development for iOS, see .NET architectural components.

Visual Studio 2019 Support for Linux Development

Visual Studio 2019 enables you to build and debug apps for Linux using C++, Python, and Node.js.Creating C++ apps for Linux requires theVisual C++ for Linux Development extension. Creating apps with Python orNode,js, requires that you enable remote debugging on the target Linux machine. You can also create, buildand remote debug .NET Core and ASP.NET Core applications for Linux using modern languages such as C#, VB and F#.


For information on .NET development for Linux, see .NET architectural components.

  • CentOS 7.1 and Oracle Linux 7.1
  • Debian 8
  • Fedora 23
  • Linux Mint 17
  • openSUSE 13.2
  • Red Hat Enterprise Linux 7.2
  • Ubuntu 14.04 and 16.04


For more information see https://dot.net/core.

Visual Studio 2019 Support for macOS Development

Visual Studio 2019 enables you to build console applications and ASP.NET applications that target macOS.However, debugging is not supported. For additional macOS development tools choices, try Visual StudioCode or Visual Studio for Mac. Visual Studio Code provides a streamlined,extensible developer tool experience for macOS. Visual Studio for Macprovides a feature-rich IDE that enables you to build native macOS apps, including ASP.NET, using C#.


For information on .NET development forMacOS, see .NET architectural components.

Other Platforms and Technologies

Visual Studio 2019 also supports the following platforms and technologies. For more information, seehttps://visualstudio.microsoft.com/vs/features/.

  • Apache Ant
  • Azure web apps and connected services, including Azure Data Lake
  • Docker
  • PowerShell
  • Web Development with ASP.NET, HTML5/CSS3, JavaScript, Node.js, Python, or TypeScript

Compatibility with Previous Releases

.NET Framework

Upgrade Docker Centos

.NET 4.7 is is a highly compatible in-place update of .NET 4, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, and 4.6.2.


For more information, see the Migration Guide to the .NET Framework 4.7, 4.6, and 4.5.

Team Explorer, Azure DevOps Server, and Team Foundation Server

Upgrade Docker Compose Windows

Team Explorer for Visual Studio 2019 will connect to Azure DevOps Server 2019, Team Foundation Server 2017,Team Foundation Server 2015, Team Foundation Server 2013, Team Foundation Server 2012, and Team Foundation Server 2010 SP1.



Silverlight projects are not supported in this version of Visual Studio. To maintain Silverlight applications,continue to use Visual Studio 2015.

Windows Store and Windows Phone apps

Projects for Windows Store 8.1 and 8.0, Windows 10 Mobile and Windows Phone are not supported in this release. Tomaintain these apps, continue to use Visual Studio 2015. To maintain Windows 10 Mobile projects, use Visual Studio 2017.To maintain Windows Phone 7.x projects, use Visual Studio 2012.

Top of Page