diff --git a/docker-for-mac/apple-silicon.md b/docker-for-mac/apple-silicon.md index b620995936..ee84b0f767 100644 --- a/docker-for-mac/apple-silicon.md +++ b/docker-for-mac/apple-silicon.md @@ -1,7 +1,7 @@ --- -description: Apple silicon -keywords: Docker Desktop, M1, Silicon, Apple, dev preview -title: Apple silicon +description: Docker Desktop for Apple silicon +keywords: Docker Desktop, M1, Silicon, Apple, +title: Docker Desktop for Apple silicon toc_min: 2 toc_max: 3 redirect_from: @@ -10,7 +10,7 @@ redirect_from: Welcome to Docker Desktop for Apple Silicon. -## Docker Desktop Apple silicon GA +## Docker Desktop for Apple silicon 2021-04-14 @@ -18,24 +18,24 @@ Click on the following link to download the GA version of Docker Desktop for App > [Download](https://desktop.docker.com/mac/stable/arm64/Docker.dmg) -### Known issues +### System requirements -The following issues are not expected to be resolved in the final GA build for Apple Silicon. - -- You must install Rosetta 2 as some binaries are still Darwin/AMD64. To install Rosetta 2 manually from the command line, use this command: +You must install **Rosetta 2** as some binaries are still Darwin/AMD64. To install Rosetta 2 manually from the command line, run the following command: ``` softwareupdate --install-rosetta ``` We expect to fix this in a future release. +### Known issues + - Not all images are available for ARM64 architecture. You can add `--platform linux/amd64` to run an Intel image under emulation. In particular, the [mysql](https://hub.docker.com/_/mysql?tab=tags&page=1&ordering=last_updated) image is not available for ARM64. You can work around this issue by using a [mariadb](https://hub.docker.com/_/mariadb?tab=tags&page=1&ordering=last_updated) image. However, attempts to run Intel-based containers on Apple Silicon machines can crash as QEMU sometimes fails to run the container. Filesystem change notification APIs (e.g. `inotify`) do not work under QEMU emulation, see [docker/for-mac#5321](https://github.com/docker/for-mac/issues/5321). Therefore, we recommend that you run ARM64 containers on Apple Silicon machines. These containers are also faster and use less memory than Intel-based containers. We expect this issue to become less common over time, as more and more images are rebuilt [supporting multiple architectures](https://www.docker.com/blog/multi-arch-build-and-images-the-simple-way/). -The following issues are seen when using the `virtualization.framework` back end. +The following issues are seen when using the `virtualization.framework` experimental feature: - Some VPN clients can prevent the VM running Docker from communicating with the host, preventing Docker Desktop starting correctly. See [docker/for-mac#5208](https://github.com/docker/for-mac/issues/5208). @@ -89,6 +89,6 @@ ADD list of issues fixed ## Feedback -Thank you for trying out the Docker Desktop for Apple Silicon. Your feedback is important to us. Let us know your feedback by creating an issue in the [Docker Desktop for Mac GitHub](https://github.com/docker/for-mac/issues)repository. +Thank you for trying out the Docker Desktop for Apple silicon. Your feedback is important to us. Let us know your feedback by creating an issue in the [Docker Desktop for Mac GitHub](https://github.com/docker/for-mac/issues)repository. We also recommend that you join the [Docker Community Slack](https://www.docker.com/docker-community) and ask questions in **#docker-desktop-mac** channel. diff --git a/docker-for-mac/install.md b/docker-for-mac/install.md index 59d1663eb2..fe962c99c5 100644 --- a/docker-for-mac/install.md +++ b/docker-for-mac/install.md @@ -34,7 +34,7 @@ Your Mac must meet the following requirements to successfully install Docker Des - VirtualBox prior to version 4.3.30 must not be installed as it is not compatible with Docker Desktop. -### Mac with Apple chip +### Mac with Apple silicon - You must install **Rosetta 2** as some binaries are still Darwin/AMD64. To install Rosetta 2 manually from the command line, run the following command: @@ -42,7 +42,7 @@ Your Mac must meet the following requirements to successfully install Docker Des softwareupdate --install-rosetta ``` - For more information about Docker Desktop for Apple silicon, see [Apple silicon](apple-silicon.md). + For more information, see [Docker Desktop for Apple silicon](apple-silicon.md). ## What's included in the installer diff --git a/docker-for-mac/release-notes.md b/docker-for-mac/release-notes.md index 04ba4a352b..08da45728f 100644 --- a/docker-for-mac/release-notes.md +++ b/docker-for-mac/release-notes.md @@ -11,10 +11,25 @@ toc_max: 2 This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases. +## Docker Desktop 3.3.1 +2021-04-14 + +> [Download for Mac with Intel chip](https://desktop.docker.com/mac/stable/amd64/Docker.dmg) + +> [Download for Mac with Apple chip](https://desktop.docker.com/mac/stable/arm64/Docker.dmg) + +### New + +Docker Desktop for Mac on Apple silicon is now available a GA release. For more information, see [Docker Desktop for Apple silicon](apple-silicon.md). + +### Bug fixes and minor changes + +- **Mac with Apple silicon**: Docker Desktop now ensures the permissions of `/dev/null` are correctly set to `0666` (`rw-rw-rw-`) inside `--privileged` containers. Fixes [docker/for-mac#5527](https://github.com/docker/for-mac/issues/5527). + ## Docker Desktop 3.3.0 2021-04-08 -> [Download](https://desktop.docker.com/mac/stable/amd64/Docker.dmg) +> [Download](ADD URL) ### New diff --git a/docker-for-mac/troubleshoot.md b/docker-for-mac/troubleshoot.md index 20ade4ea4a..bc3b362232 100644 --- a/docker-for-mac/troubleshoot.md +++ b/docker-for-mac/troubleshoot.md @@ -152,10 +152,6 @@ ways, and create reports. ## Troubleshooting -### Support for Apple silicon processors - -At the moment, Docker Desktop is compatible with Intel processors only. You can learn more about the technical preview for Apple silicon in our [docs](apple-m1.md). - ### Make sure certificates are set up correctly Docker Desktop ignores certificates listed under insecure registries, and does @@ -248,6 +244,34 @@ in the Apple documentation, and Docker Desktop [Mac system requirements](install ## Known issues +### Apple silicon + +The following issues are seen when using the `virtualization.framework` experimental feature: + +* Some VPN clients can prevent the VM running Docker from communicating with the host, preventing Docker Desktop starting correctly. See [docker/for-mac#5208](https://github.com/docker/for-mac/issues/5208). + + This is an interaction between `vmnet.framework` (as used by `virtualization.framework` in Big Sur) and the VPN clients. + +* Docker Desktop is incompatible with macOS Internet Sharing. See [docker/for-mac#5348](https://github.com/docker/for-mac/issues/5348). + + This is an interaction between `vmnet.framework` (as used by `virtualization.framework` in Big Sur) and macOS Internet Sharing. At the moment it is not possible to use Docker Desktop and macOS Internet Sharing at the same time. + +* Some container disk I/O is much slower than expected. See [docker/for-mac#5389](https://github.com/docker/for-mac/issues/5389). Disk flushes are particularly slow due to the need to guarantee data is written to stable storage on the host. + + This is an artifact of the new `virtualization.framework` in Big Sur. + +* TCP and UDP port 53 (DNS) are bound on the host when Docker Desktop starts. Therefore you cannot bind to port 53 on all interfaces with a command like `docker run -p 53:53`. See [docker/for-mac#5335](https://github.com/docker/for-mac/issues/5335). + + This is an artifact of the new `virtualization.framework` in Big Sur. A workaround is to bind to a specific IP address e.g. `docker run -p 127.0.0.1:53:53`. + +- The Linux Kernel may occasionally crash. Docker now detects this problem and pops up an error dialog offering the user the ability to quickly restart Linux. + + We are still gathering data and testing alternate kernel versions. + +For more information, see [Docker Desktop for Apple silicon](apple-silicon.md). + +### General + * IPv6 is not (yet) supported on Docker Desktop. * You might encounter errors when using `docker-compose up` with Docker Desktop diff --git a/docker-for-windows/release-notes.md b/docker-for-windows/release-notes.md index f50589645e..33a50e9c4c 100644 --- a/docker-for-windows/release-notes.md +++ b/docker-for-windows/release-notes.md @@ -11,10 +11,19 @@ toc_max: 2 This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases. +## Docker Desktop 3.3.1 +2021-04-14 + +> [Download](https://desktop.docker.com/win/stable/amd64/Docker%20Desktop%20Installer.exe) + +### Bug fixes and minor changes + + - Fixed an issue that caused `docker run` to fail when using `\\wsl.localhost` path to a directory. Fixes [docker/for-win#10786](https://github.com/docker/for-win/issues/10786) + ## Docker Desktop 3.3.0 2021-04-08 -> [Download](https://desktop.docker.com/win/stable/amd64/Docker%20Desktop%20Installer.exe) +> [Download](Add URL) ### New