Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

desktop/settings: Add Docker VMM #20986

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions content/manuals/desktop/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,15 +59,17 @@
and the ability to run Wasm applications with Docker.
For more information, see [containerd image store](containerd.md).

- {{< badge color=blue text="Mac only" >}} **Use Virtualization framework**. Select to allow Docker Desktop to use the `virtualization.framework` instead of the `hypervisor.framework`.
- {{< badge color=blue text="Mac only" >}} **Choose Virtual Machine Manager (VMM)**. Choose the Virtual Machine Monitor for creating and managing the Docker Desktop Linux VM.
- Select **Docker VMM** for the latest and most performant Hypervisor/Virtual Machine Manager. This option is available only on Apple Silicon Macs running macOS 12.5 or later.

Check warning on line 63 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] ' VMM' has no definition. Raw Output: {"message": "[Docker.Acronyms] ' VMM' has no definition.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 63, "column": 20}}}, "severity": "WARNING"}

Check failure on line 63 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'performant'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'performant'?", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 63, "column": 51}}}, "severity": "ERROR"}
> [!TIP]
>
> Turn this setting on to make Docker Desktop run faster.
- Alternatively, you can choose **Apple Virtualization Framework**, **QEMU** (for Apple Silicon), or **Hyperkit** (for Intel Macs). For macOS 12.5 and above, Apple Virtualization Framework is the default setting.

Check failure on line 67 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Terms] Use 'HyperKit' instead of 'Hyperkit'. Raw Output: {"message": "[Vale.Terms] Use 'HyperKit' instead of 'Hyperkit'.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 67, "column": 106}}}, "severity": "ERROR"}

Check warning on line 67 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.VersionText] Use later when talking about version numbers. Raw Output: {"message": "[Docker.VersionText] Use later when talking about version numbers.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 67, "column": 145}}}, "severity": "WARNING"}

Check warning on line 67 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.RecommendedWords] Consider using 'previous' instead of 'above' Raw Output: {"message": "[Docker.RecommendedWords] Consider using 'previous' instead of 'above'", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 67, "column": 154}}}, "severity": "INFO"}

- {{< badge color=blue text="Mac only" >}}**Choose file sharing implementation for your containers**. Choose whether you want to share files using **VirtioFS**, **gRPC FUSE**, or **osxfs (Legacy)**. VirtioFS is only available for macOS versions 12.5 and above, and is turned on by default.
>**Tip**
> [!TIP]
>
> Use VirtioFS for speedy file sharing. VirtioFS has reduced the time taken to complete filesystem operations by [up to 98%](https://github.com/docker/roadmap/issues/7#issuecomment-1044452206)
> Use VirtioFS for speedy file sharing. VirtioFS has reduced the time taken to complete filesystem operations by [up to 98%](https://github.com/docker/roadmap/issues/7#issuecomment-1044452206). It is the only file sharing implementation supported by **Docker VMM**.

Check failure on line 72 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Terms] Use 'virtiofs' instead of 'VirtioFS'. Raw Output: {"message": "[Vale.Terms] Use 'virtiofs' instead of 'VirtioFS'.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 72, "column": 11}}}, "severity": "ERROR"}

Check failure on line 72 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Terms] Use 'virtiofs' instead of 'VirtioFS'. Raw Output: {"message": "[Vale.Terms] Use 'virtiofs' instead of 'VirtioFS'.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 72, "column": 45}}}, "severity": "ERROR"}

Check warning on line 72 in content/manuals/desktop/settings.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] ' VMM' has no definition. Raw Output: {"message": "[Docker.Acronyms] ' VMM' has no definition.", "location": {"path": "content/manuals/desktop/settings.md", "range": {"start": {"line": 72, "column": 263}}}, "severity": "WARNING"}

- {{< badge color=blue text="Mac only" >}}**Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. Turns on Rosetta to accelerate x86/AMD64 binary emulation on Apple Silicon. This option is only available if you have turned on **Virtualization framework** in the **General** settings tab. You must also be on macOS Ventura or later.

Expand Down Expand Up @@ -505,4 +507,4 @@

- **Enable privileged port mapping (Requires password)**. Starts the privileged helper process which binds the ports that are between 1 and 1024. For more information, see [permission requirements for macOS](/manuals/desktop/install/mac-permission-requirements.md#binding-privileged-ports).

For more information on each configuration and use case, see [Permission requirements](/manuals/desktop/install/mac-permission-requirements.md).
For more information on each configuration and use case, see [Permission requirements](/manuals/desktop/install/mac-permission-requirements.md).
Loading