From ec66fe5610136f0ed18823a0f05108ca620beb13 Mon Sep 17 00:00:00 2001 From: David Scott Date: Thu, 12 Dec 2024 16:37:39 +0000 Subject: [PATCH 1/2] 4.37: highlight that (Legacy) Qemu VMM + osxfs will be removed in a future version For filesharing, anyone still using osxfs should switch to virtiofs which is faster and more stable. For running the Linux VM locally, anyone still using Qemu on Apple Silicon should switch to virtualization.framework which is also faster and more stable. In case someone hits a problem and needs help, include links to support and the github issue tracker. Some history: - In 2020 osxfs was marked as legacy (Docker Desktop 2.4.2.0). - In 2023 with the release of macOS 14, all supported macOS versions (current release plus previous two) use virtualization.framework by default. - In 2024 (Docker Desktop 4.36) Qemu as a VMM was marked as legacy in the UI. Signed-off-by: David Scott --- content/manuals/desktop/release-notes.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index e905db733007..bad30c9e3fba 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -66,6 +66,13 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec - Kubernetes cluster may not start if **Registry Access Manager** is enabled. As a workaround, add `registry.k8s.io` and `-docker.pkg.dev` to **Registry Access Management** policies. +### Deprecation + +#### For Mac + +- QEMU (Legacy) as a VMM on Apple Silicon will be removed in a future version. Please switch to virtualization.framework for increased performance and stability. If you encounter an issue, [contact support](https://www.docker.com/support/) or file a [github issue](https://github.com/docker/for-mac/issues). +- osxfs (Legacy) will be removed in a future version. Please switch to VirtioFS for increased performance. If you encounter an issue, [contact support](https://www.docker.com/support/) or file a [github issue](https://github.com/docker/for-mac/issues). + ## 4.36.0 {{< release-date date="2024-11-18" >}} From b8f3c2d8cc92d3c02827f34102ff925b28a0a2a8 Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Fri, 13 Dec 2024 12:47:27 +0000 Subject: [PATCH 2/2] Apply suggestions from code review --- content/manuals/desktop/release-notes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index bad30c9e3fba..5ee5e07004d0 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -70,8 +70,8 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec #### For Mac -- QEMU (Legacy) as a VMM on Apple Silicon will be removed in a future version. Please switch to virtualization.framework for increased performance and stability. If you encounter an issue, [contact support](https://www.docker.com/support/) or file a [github issue](https://github.com/docker/for-mac/issues). -- osxfs (Legacy) will be removed in a future version. Please switch to VirtioFS for increased performance. If you encounter an issue, [contact support](https://www.docker.com/support/) or file a [github issue](https://github.com/docker/for-mac/issues). +- QEMU (Legacy) as a VMM on Apple Silicon will be removed in a future version. It is recommended that you switch to the Apple Virtualization Framework for increased performance and stability. If you encounter an issue, [contact Docker Support](https://www.docker.com/support/) or [file a GitHub issue](https://github.com/docker/for-mac/issues). +- osxfs (Legacy) will be removed in a future version. It is recommended that you switch to VirtioFS for increased performance. If you encounter an issue, [contact Docker Support](https://www.docker.com/support/) or [file a GitHub issue](https://github.com/docker/for-mac/issues). ## 4.36.0