diff --git a/docker-for-mac/apple-silicon.md b/docker-for-mac/apple-silicon.md index 2943e8b54b..c3abfa2fce 100644 --- a/docker-for-mac/apple-silicon.md +++ b/docker-for-mac/apple-silicon.md @@ -39,14 +39,14 @@ We expect to fix this in a future release. 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/). - - When using the `qemu` backend, `ping` from inside a container to the Internet does not work as expected. To test the network, we recommend using `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861). +- ICMP echo responses (`ping` responses) can contain incorrect sequence numbers. +- Users may occasionally experience data drop when a TCP stream is half-closed. + ### Fixes since Docker Desktop RC 3 - 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](https://github.com/docker/for-mac/issues/5527). -- Fixed an issue where ICMP echo responses (`ping` responses) had incorrect sequence numbers. -- Fixed an issue where data was dropped when a TCP stream was half-closed. - Docker Desktop now reduces the idle CPU consumption. ### Fixes since Docker Desktop RC 2 diff --git a/docker-for-mac/release-notes.md b/docker-for-mac/release-notes.md index c0252a08d7..bd843f7325 100644 --- a/docker-for-mac/release-notes.md +++ b/docker-for-mac/release-notes.md @@ -26,11 +26,20 @@ Docker Desktop is now available for Apple silicon as well as Intel chips. This e - 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](https://github.com/docker/for-mac/issues/5527) - 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](https://github.com/docker/for-win/issues/10896) -**Mac with Apple silicon** +- **Mac with Apple silicon**: Docker Desktop now reduces the idle CPU consumption. -- Fixed an issue where ICMP echo responses (`ping` responses) had incorrect sequence numbers. -- Fixed an issue where data was dropped when a TCP stream was half-closed. -- Docker Desktop now reduces the idle CPU consumption. +### Known issues + +**Apple silicon** + +- 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/). +- When using the `qemu` backend, `ping` from inside a container to the Internet does not work as expected. To test the network, we recommend using `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861). +- ICMP echo responses (`ping` responses) can contain incorrect sequence numbers. +- Users may occasionally experience data drop when a TCP stream is half-closed. ## Docker Desktop 3.3.0 2021-04-08