mirror of https://github.com/docker/docs.git
mac-install-refine (#16082)
* mac-install-refine * fix links * Update compose/compose-v2/index.md Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
Allie Sadler
GitHub
parent
59b19c2dce
commit
79fc8d6ddc
|
|
@ -1217,8 +1217,6 @@ manuals:
|
|||
title: Install on Windows
|
||||
- path: /desktop/windows/permission-requirements/
|
||||
title: Understand permission requirements for Windows
|
||||
- path: /desktop/mac/apple-silicon/
|
||||
title: Install on Apple silicon
|
||||
- path: /desktop/install/linux-install/
|
||||
title: Install on Linux
|
||||
- sectiontitle: Installation per Linux distro
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ such as [profiles](../profiles.md) and [GPU](../gpu-support.md) devices.
|
|||
|
||||
Compose V2 has been re-written in [Go](https://go.dev), which improves integration
|
||||
with other Docker command-line features, and allows it to run natively on
|
||||
[macOS on Apple silicon](../../desktop/mac/apple-silicon.md), Windows, and Linux,
|
||||
[macOS on Apple silicon](../../desktop/install/mac-install.md), Windows, and Linux,
|
||||
without dependencies such as Python.
|
||||
|
||||
For more information about compatibility with the compose v1 command-line, see the [docker-compose compatibility list](../cli-command-compatibility.md).
|
||||
|
|
@ -7,6 +7,9 @@ redirect_from:
|
|||
- /docker-for-mac/install/
|
||||
- /engine/installation/mac/
|
||||
- /installation/mac/
|
||||
- /docker-for-mac/apple-m1/
|
||||
- /docker-for-mac/apple-silicon/
|
||||
- /desktop/mac/apple-silicon/
|
||||
---
|
||||
|
||||
> **Docker Desktop terms**
|
||||
|
|
@ -50,13 +53,13 @@ Your Mac must meet the following requirements to install Docker Desktop successf
|
|||
|
||||
### Mac with Apple silicon
|
||||
|
||||
- Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install **Rosetta 2**. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See the [Known issues section](../mac/apple-silicon.md#known-issues). However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
|
||||
- Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install **Rosetta 2**. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See the [Known issues section](../troubleshoot/known-issues.md). However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
|
||||
|
||||
```console
|
||||
$ softwareupdate --install-rosetta
|
||||
```
|
||||
|
||||
For more information, see [Docker Desktop for Apple silicon](../mac/apple-silicon.md).
|
||||
For more information, see [Docker Desktop for Apple silicon](../install/mac-install.md).
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -107,7 +110,7 @@ The `install` command accepts the following flags:
|
|||
|
||||
## Where to go next
|
||||
|
||||
- [Docker Desktop for Apple silicon](../mac/apple-silicon.md) for detailed information about Docker Desktop for Apple silicon.
|
||||
- [Docker Desktop for Apple silicon](../install/mac-install.md) for detailed information about Docker Desktop for Apple silicon.
|
||||
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how
|
||||
to run and submit diagnostics, and submit issues.
|
||||
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
|
||||
|
|
|
|||
|
|
@ -1,68 +0,0 @@
|
|||
---
|
||||
description: Docker Desktop for Apple silicon
|
||||
keywords: Docker Desktop, M1, Silicon, Apple,
|
||||
title: Docker Desktop for Apple silicon
|
||||
redirect_from:
|
||||
- /docker-for-mac/apple-m1/
|
||||
- /docker-for-mac/apple-silicon/
|
||||
---
|
||||
|
||||
Docker Desktop for Mac on Apple silicon is now available as a GA release. This enables you to develop applications with your choice of local development environments, and extends development pipelines for ARM-based applications.
|
||||
|
||||
Docker Desktop for Apple silicon also supports multi-platform images, which allows you to build and run images for both x86 and ARM architectures without having to set up a complex cross-compilation development environment. Additionally, you can use [docker buildx](../../engine/reference/commandline/buildx.md){:target="_blank" rel="noopener" class="_"} to seamlessly integrate multi-platform builds into your build pipeline, and use [Docker Hub](https://hub.docker.com/){:target="_blank" rel="noopener" class="_"} to identify and share repositories that provide multi-platform images.
|
||||
|
||||
Download Docker Desktop for Mac on Apple silicon:
|
||||
|
||||
> Download Docker Desktop
|
||||
>
|
||||
>
|
||||
> [Mac with Apple chip](https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64){: .button .primary-btn }
|
||||
|
||||
### System requirements
|
||||
|
||||
Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install **Rosetta 2**. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See the Known issues section below. However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
|
||||
|
||||
```console
|
||||
$ softwareupdate --install-rosetta
|
||||
```
|
||||
|
||||
### Known issues
|
||||
|
||||
- Some command line tools do not work when Rosetta 2 is not installed.
|
||||
- The old version 1.x of `docker-compose`. We recommend that you use Compose V2 instead. Either type `docker compose` or enable the **Use Docker Compose V2** option in the [General preferences tab](../settings/mac.md#general).
|
||||
- The `docker scan` command and the underlying `snyk` binary.
|
||||
- The `docker-credential-ecr-login` credential helper.
|
||||
- Some images do not support the ARM64 architecture. You can add `--platform linux/amd64` to run (or build) an Intel image using emulation.
|
||||
|
||||
However, attempts to run Intel-based containers on Apple silicon machines under emulation can crash as qemu sometimes fails to run the container. In addition, filesystem change notification APIs (`inotify`) do not work under qemu emulation. Even when the containers do run correctly under emulation, they will be slower and use more memory than the native equivalent.
|
||||
|
||||
In summary, running Intel-based containers on Arm-based machines should be regarded as "best effort" only. We recommend running arm64 containers on Apple silicon machines whenever possible, and encouraging container authors to produce arm64, or multi-arch, versions of their 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/).
|
||||
- `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).
|
||||
- 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).
|
||||
- Docker Desktop now reduces the idle CPU consumption.
|
||||
|
||||
### Fixes since Docker Desktop RC 2
|
||||
|
||||
- Update to [Linux kernel 5.10.25](https://hub.docker.com/layers/docker/for-desktop-kernel/5.10.25-6594e668feec68f102a58011bb42bd5dc07a7a9b/images/sha256-80e22cd9c9e6a188a785d0e23b4cefae76595abe1e4a535449627c2794b10871?context=repo) to improve reliability.
|
||||
|
||||
### Fixes since Docker Desktop RC 1
|
||||
|
||||
- Inter-container HTTP and HTTPS traffic is now routed correctly. Fixes [docker/for-mac#5476](https://github.com/docker/for-mac/issues/5476).
|
||||
|
||||
### Fixes since Docker Desktop preview 3.1.0
|
||||
|
||||
- The build should update automatically to future versions.
|
||||
- HTTP proxy support is working, including support for domain name based `no_proxy` rules via TLS SNI. Fixes [docker/for-mac#2732](https://github.com/docker/for-mac/issues/2732).
|
||||
|
||||
### Fixes since the Apple silicon preview 7
|
||||
|
||||
- Kubernetes now works (although you might need to reset the cluster in our Troubleshoot menu one time to regenerate the certificates).
|
||||
- osxfs file sharing works.
|
||||
- The `host.docker.internal` and `vm.docker.internal` DNS entries now resolve.
|
||||
- Removed hard-coded IP addresses: Docker Desktop now dynamically discovers the IP allocated by macOS.
|
||||
- The updated version includes a change that should improve disk performance.
|
||||
- The **Restart** option in the Docker menu works.
|
||||
|
|
@ -257,7 +257,7 @@ This page contains release notes for Docker Desktop for Mac 3.x.
|
|||
|
||||
### New
|
||||
|
||||
Docker Desktop is now available for Apple silicon as well as Intel chips. This enables developers with their choice of local development environments, and extends development pipelines for ARM-based applications. For more information, see [Docker Desktop for Apple silicon](../mac/apple-silicon.md).
|
||||
Docker Desktop is now available for Apple silicon as well as Intel chips. This enables developers with their choice of local development environments, and extends development pipelines for ARM-based applications. For more information, see [Docker Desktop for Apple silicon](../install/mac-install.md).
|
||||
|
||||
### Bug fixes and minor changes
|
||||
|
||||
|
|
|
|||
|
|
@ -1149,7 +1149,7 @@ CVE-2021-44228](https://www.docker.com/blog/apache-log4j-2-cve-2021-44228/){: ta
|
|||
|
||||
#### For Mac
|
||||
|
||||
- Docker Desktop on Apple silicon no longer requires Rosetta 2, with the exception of [three optional command line tools](mac/apple-silicon.md#known-issues).
|
||||
- Docker Desktop on Apple silicon no longer requires Rosetta 2, with the exception of [three optional command line tools](troubleshoot/known-issues.md).
|
||||
|
||||
#### For Windows
|
||||
|
||||
|
|
|
|||
|
|
@ -3,6 +3,13 @@ description: Known issues for Mac
|
|||
keywords: mac, troubleshooting, known issues
|
||||
title: Known issues for Docker Desktop on Mac
|
||||
---
|
||||
<ul class="nav nav-tabs">
|
||||
<li class="active"><a data-toggle="tab" data-target="#tab3">Known issues for Mac with Intel chip</a></li>
|
||||
<li><a data-toggle="tab" data-target="#tab4">Known issues for Mac with Apple silicon</a></li>
|
||||
</ul>
|
||||
<div class="tab-content">
|
||||
<div id="tab3" class="tab-pane fade in active" markdown="1">
|
||||
<br>
|
||||
* 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).
|
||||
|
|
@ -77,3 +84,21 @@ title: Known issues for Docker Desktop on Mac
|
|||
actively working on performance improvements using a number of different
|
||||
techniques. To learn more, see the [topic on our roadmap](https://github.com/docker/roadmap/issues/7){: target="_blank" rel="noopener" class="_" }.
|
||||
|
||||
<hr>
|
||||
</div>
|
||||
<div id="tab4" class="tab-pane fade" markdown="1">
|
||||
<br>
|
||||
- Some command line tools do not work when Rosetta 2 is not installed.
|
||||
- The old version 1.x of `docker-compose`. We recommend that you use Compose V2 instead. Either type `docker compose` or enable the **Use Docker Compose V2** option in the [General preferences tab](../settings/mac.md#general).
|
||||
- The `docker scan` command and the underlying `snyk` binary.
|
||||
- The `docker-credential-ecr-login` credential helper.
|
||||
- Some images do not support the ARM64 architecture. You can add `--platform linux/amd64` to run (or build) an Intel image using emulation.
|
||||
|
||||
However, attempts to run Intel-based containers on Apple silicon machines under emulation can crash as qemu sometimes fails to run the container. In addition, filesystem change notification APIs (`inotify`) do not work under qemu emulation. Even when the containers do run correctly under emulation, they will be slower and use more memory than the native equivalent.
|
||||
|
||||
In summary, running Intel-based containers on Arm-based machines should be regarded as "best effort" only. We recommend running arm64 containers on Apple silicon machines whenever possible, and encouraging container authors to produce arm64, or multi-arch, versions of their 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/).
|
||||
- `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).
|
||||
- Users may occasionally experience data drop when a TCP stream is half-closed.
|
||||
<hr>
|
||||
</div>
|
||||
</div>
|
||||
Loading…
Reference in New Issue