ENGDOCS-2283 (#21329)

<!--Delete sections as needed -->

## Description

Tidy up of DD IA. Creates a 'setup' folder and moves relevant pages
within it. First PR of a few

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
This commit is contained in:
Allie Sadler 2024-11-05 10:07:48 +00:00 committed by GitHub
parent 48f3bcc826
commit 3ea0cd758d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
44 changed files with 116 additions and 84 deletions

View File

@ -34,7 +34,7 @@ section and choose the best installation path for you.
{{< card
title="Docker Desktop for Mac"
description="A native application using the macOS sandbox security model that delivers all Docker tools to your Mac."
link="/desktop/install/mac-install/"
link="/desktop/setup/install/mac-install/"
icon="/assets/images/apple_48.svg" >}}
<br>
@ -42,7 +42,7 @@ section and choose the best installation path for you.
{{< card
title="Docker Desktop for Windows"
description="A native Windows application that delivers all Docker tools to your Windows computer."
link="/desktop/install/windows-install/"
link="/desktop/setup/install/windows-install/"
icon="/assets/images/windows_48.svg" >}}
<br>

View File

@ -28,14 +28,14 @@ This guide will walk you through the installation process, enabling you to exper
{{< card
title="Docker Desktop for Mac"
description="[Download (Apple Silicon)](https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64) | [Download (Intel)](https://desktop.docker.com/mac/main/amd64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-amd64) | [Install instructions](/desktop/install/mac-install)"
description="[Download (Apple Silicon)](https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64) | [Download (Intel)](https://desktop.docker.com/mac/main/amd64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-amd64) | [Install instructions](/desktop/setup/install/mac-install)"
icon="/assets/images/apple_48.svg" >}}
<br>
{{< card
title="Docker Desktop for Windows"
description="[Download](https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-windows) | [Install instructions](/desktop/install/windows-install)"
description="[Download](https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-windows) | [Install instructions](/desktop/setup/install/windows-install)"
icon="/assets/images/windows_48.svg" >}}
<br>

View File

@ -12,7 +12,7 @@ aliases:
## Prerequisites
- You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
- You have completed the walkthroughs in the Docker Desktop [Learning Center](/manuals/desktop/get-started.md) to learn about Docker concepts.
- You have completed the walkthroughs in the Docker Desktop [Learning Center](/manuals/desktop/use-desktop/_index.md) to learn about Docker concepts.
- You have a [git client](https://git-scm.com/downloads). The examples in this section use a command-line based git client, but you can use any client.
## Overview

View File

@ -24,9 +24,9 @@ The easiest and recommended way to get Docker Compose is to install Docker Deskt
includes Docker Compose along with Docker Engine and Docker CLI which are Compose prerequisites.
Docker Desktop is available on:
- [Linux](/manuals/desktop/install/linux/_index.md)
- [Mac](/manuals/desktop/install/mac-install.md)
- [Windows](/manuals/desktop/install/windows-install.md)
- [Linux](/manuals/desktop/setup/install/linux/_index.md)
- [Mac](/manuals/desktop/setup/install/mac-install.md)
- [Windows](/manuals/desktop/setup/install/windows-install.md)
If you have already installed Docker Desktop, you can check which version of Compose you have by selecting **About Docker Desktop** from the Docker menu {{< inline-image src="../../desktop/images/whale-x.svg" alt="whale menu" >}}.

View File

@ -3848,7 +3848,7 @@ The highlights:
This means the GitHub repository has moved to [https://github.com/docker/fig](https://github.com/docker/fig) and our IRC channel is now #docker-fig on Freenode.
- Fig can be used with the [official Docker OS X installer](/manuals/desktop/install/mac-install.md). Boot2Docker will mount the home directory from your host machine so volumes work as expected.
- Fig can be used with the [official Docker OS X installer](/manuals/desktop/setup/install/mac-install.md). Boot2Docker will mount the home directory from your host machine so volumes work as expected.
- Fig supports Docker 1.3.

View File

@ -9,8 +9,8 @@ grid:
- title: Install Docker Desktop
description: |
Install Docker Desktop on
[Mac](/desktop/install/mac-install/),
[Windows](/desktop/install/windows-install/), or
[Mac](/desktop/setup/install/mac-install/),
[Windows](/desktop/setup/install/windows-install/), or
[Linux](/desktop/install/linux/).
icon: download
- title: Explore Docker Desktop

View File

@ -189,7 +189,7 @@ Docker Desktop 2.4.0.0 contains a Kubernetes upgrade. Your local Kubernetes clus
### New
- Windows 10 Home users can now use Docker Desktop through WSL 2. This requires Windows 10, version 2004 or higher. For more information, see [Install Docker Desktop on Windows](../install/windows-install.md).
- Windows 10 Home users can now use Docker Desktop through WSL 2. This requires Windows 10, version 2004 or higher. For more information, see [Install Docker Desktop on Windows](/manuals/desktop/setup/install/windows-install.md).
- Docker Desktop introduces a new onboarding tutorial upon first startup. The Quick Start tutorial guides users to get started with Docker in a few easy steps. It includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
- Docker Desktop now allows sharing individual folders, rather than whole drives, giving more control to users over what is being shared.

View File

@ -202,7 +202,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](../install/mac-install.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](/manuals/desktop/setup/install/mac-install.md).
### Bug fixes and minor changes

View File

@ -12,7 +12,7 @@ sitemap: false
This page contains information about Docker Desktop Edge releases. Edge releases give you early access to our newest features. Note that some of the features may be experimental, and some of them may not ever reach the Stable release.
For Docker Desktop system requirements, see
[What to know before you install](../install/mac-install.md#system-requirements).
[What to know before you install](/manuals/desktop/setup/install/mac-install.md#system-requirements).
## Docker Desktop Community 2.5.4
2020-12-07
@ -1855,7 +1855,7 @@ events or unexpected unmounts.
**New**
* Docker for Mac is now available from 2 channels: **stable** and **beta**. New features and bug fixes will go out first in auto-updates to users in the beta channel. Updates to the stable channel are much less frequent and happen in sync with major and minor releases of the Docker engine. Only features that are well-tested and ready for production are added to the stable channel releases. For downloads of both and more information, see the [installation guide](../install/mac-install.md).
* Docker for Mac is now available from 2 channels: **stable** and **beta**. New features and bug fixes will go out first in auto-updates to users in the beta channel. Updates to the stable channel are much less frequent and happen in sync with major and minor releases of the Docker Engine. Only features that are well-tested and ready for production are added to the stable channel releases. For downloads of both and more information, see the [installation guide](/manuals/desktop/setup/install/mac-install.md).
**Upgrades**

View File

@ -12,7 +12,7 @@ sitemap: false
This page contains information about Docker Desktop Edge releases. Edge releases give you early access to our newest features. Note that some of the features may be experimental, and some of them may not ever reach the Stable release.
For Docker Desktop system requirements, see
[What to know before you install](../install/windows-install.md#system-requirements).
[What to know before you install](/manuals/desktop/setup/install/windows-install.md#system-requirements).
## Docker Desktop Community 2.5.4
2020-12-07
@ -2006,7 +2006,7 @@ Unreleased. See Beta 23 for changes.
**New**
* Docker for Windows is now available from two channels: **stable** and **beta**. New features and bug fixes go out first in auto-updates to users in the beta channel. Updates to the stable channel are much less frequent and happen in sync with major and minor releases of the Docker engine. Only features that are well-tested and ready for production are added to the stable channel releases. For downloads of both and more information, see [Install Docker Desktop on Windows](../install/windows-install.md).
* Docker for Windows is now available from two channels: **stable** and **beta**. New features and bug fixes go out first in auto-updates to users in the beta channel. Updates to the stable channel are much less frequent and happen in sync with major and minor releases of the Docker Engine. Only features that are well-tested and ready for production are added to the stable channel releases. For downloads of both and more information, see [Install Docker Desktop on Windows](/manuals/desktop/setup/install/windows-install.md).
* Removed the docker host name. Containers with exported ports are reachable via localhost.

View File

@ -41,7 +41,7 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec
### New
- Support for [Docker Desktop on Red Hat Enterprise Linux](/manuals/desktop/install/linux/rhel.md) is now generally available.
- Support for [Docker Desktop on Red Hat Enterprise Linux](/manuals/desktop/setup/install/linux/rhel.md) is now generally available.
- Volume Backup and Share is now generally available and can be found in the **Volumes** view.
- Terminal support within Docker Desktop using system shells is now generally available.
- Beta release of Docker VMM - the more performant alternative to Apple Virtualization Framework on macOS (requires Apple Silicon and macOS 12.5 or later).
@ -165,7 +165,7 @@ Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projec
- [Host networking](/manuals/engine/network/drivers/host.md#docker-desktop) support on Docker Desktop is now generally available.
- If you authenticate via the CLI, you can now authenticate through a browser-based flow, removing the need for manual PAT generation.
- Windows now supports automatic reclamation of disk space in Docker Desktop for WSL2 installations [using a managed virtual hard disk](/manuals/desktop/wsl/best-practices.md).
- Deploying Docker Desktop via the [MSI installer](/manuals/desktop/install/msi/_index.md) is now generally available.
- Deploying Docker Desktop via the [MSI installer](/manuals/desktop/setup/install/msi/_index.md) is now generally available.
- Two new methods to [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) (windows registry key and `.plist` file) are now generally available.
- Fresh installations of Docker Desktop now use the containerd image store by default.
- [Compose Bridge](/manuals/compose/bridge/_index.md) (Experimental) is now available from the Compose file viewer. Easily convert and deploy your Compose project to a Kubernetes cluster.
@ -347,7 +347,7 @@ For more information, see [microsoft/WSL#11794](https://github.com/microsoft/WSL
#### For Windows
- Fixed an issue on the WSL 2 engine where Docker Desktop would not detect the existence of the `docker-desktop-data` distribution if it had been manually moved by the user.
- The Windows on ARM installer and the [privileged service](/manuals/desktop/install/windows-permission-requirements.md#privileged-helper) are now built for ARM64.
- The Windows on ARM installer and the [privileged service](/manuals/desktop/setup/install/windows-permission-requirements.md#privileged-helper) are now built for ARM64.
#### For Mac
@ -1406,7 +1406,7 @@ This can be resolved by adding the user to the **docker-users** group. Before st
- Improved `docker scout compare` command to compare two images, now also aliased under `docker scout diff`.
- Added more details to dashboard errors when a `docker-compose` action fails ([docker/for-win#13378](https://github.com/docker/for-win/issues/13378)).
- Added support for setting HTTP proxy configuration during installation. This can be done via the `--proxy-http-mode`, `--overrider-proxy-http`, `--override-proxy-https` and `--override-proxy-exclude` installer flags in the case of installation from the CLI on [Mac](install/mac-install.md#install-from-the-command-line) and [Windows](install/windows-install.md#install-from-the-command-line), or alternatively by setting the values in the `install-settings.json` file.
- Added support for setting HTTP proxy configuration during installation. This can be done via the `--proxy-http-mode`, `--overrider-proxy-http`, `--override-proxy-https` and `--override-proxy-exclude` installer flags in the case of installation from the CLI on [Mac](/manuals/desktop/setup/install/mac-install.md#install-from-the-command-line) and [Windows](/manuals/desktop/setup/install/windows-install.md#install-from-the-command-line), or alternatively by setting the values in the `install-settings.json` file.
- Docker Desktop now stops overriding .docker/config.json `credsStore` keys on application start. Note that if you use a custom credential helper then the CLI `docker login` and `docker logout` does not affect whether the UI is signed in to Docker or not. In general, it is better to sign into Docker via the UI since the UI supports multi-factor authentication.
- Added a warning about the [forthcoming removal of Compose V1 from Docker Desktop](/manuals/compose/releases/migrate.md). Can be suppressed with `COMPOSE_V1_EOL_SILENT=1`.
- In the Compose config, boolean fields in YAML should be either `true` or `false`. Deprecated YAML 1.1 values such as “on” or “no” now produce a warning.
@ -2020,7 +2020,7 @@ This can be resolved by adding the user to the **docker-users** group. Before st
### New
- Docker Desktop is now fully supported for Docker Business customers inside VMware ESXi and Azure VMs. For more information, see [Run Docker Desktop inside a VM or VDI environment](/manuals/desktop/vm-vdi.md)
- Docker Desktop is now fully supported for Docker Business customers inside VMware ESXi and Azure VMs. For more information, see [Run Docker Desktop inside a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md)
- Added two new extensions ([vcluster](https://hub.docker.com/extensions/loftsh/vcluster-dd-extension) and [PGAdmin4](https://hub.docker.com/extensions/mochoa/pgadmin4-docker-extension)) to the Extensions Marketplace.
- The ability to sort extensions has been added to the Extensions Marketplace.
- Fixed a bug that caused some users to be asked for feedback too frequently. You'll now only be asked for feedback twice a year.
@ -2238,7 +2238,7 @@ This can be resolved by adding the user to the **docker-users** group. Before st
### New
- Released [Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md).
- Released [Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md).
- Beta release of [Docker Extensions](/manuals/extensions/_index.md) and Extensions SDK.
- Created a Docker Homepage where you can run popular images and discover how to use them.
- [Compose V2 is now GA](https://www.docker.com/blog/announcing-compose-v2-general-availability/)
@ -2259,7 +2259,7 @@ This can be resolved by adding the user to the **docker-users** group. Before st
### New
- Released [Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md).
- Released [Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md).
- Beta release of [Docker Extensions](/manuals/extensions/_index.md) and Extensions SDK.
- Created a Docker Homepage where you can run popular images and discover how to use them.
- [Compose V2 is now GA](https://www.docker.com/blog/announcing-compose-v2-general-availability/)

View File

@ -509,8 +509,8 @@ On Mac, you can reconfigure your initial installation settings on the **Advance
```
3. Save and the close the file. Restart your shell to apply the changes to the PATH variable.
- **Enable default Docker socket (Requires password)**. Creates `/var/run/docker.sock` which some third party clients may use to communicate with Docker Desktop. For more information, see [permission requirements for macOS](/manuals/desktop/install/mac-permission-requirements.md#installing-symlinks).
- **Enable default Docker socket (Requires password)**. Creates `/var/run/docker.sock` which some third party clients may use to communicate with Docker Desktop. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#installing-symlinks).
- **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).
- **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/setup/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/setup/install/mac-permission-requirements.md).

View File

@ -1,6 +1,6 @@
---
build:
render: never
title: Install
title: Setup
weight: 10
---
---

View File

@ -2,7 +2,10 @@
description: Allowlist for Docker Desktop for Business customers
keywords: Docker Desktop, allowlist, allow list, firewall
title: Allowlist for Docker Desktop
linkTitle: Allowlist
weight: 100
aliases:
- /desktop/allow-list/
---
This page contains the domain URLs that you need to add to a firewall allowlist to ensure Docker Desktop works properly within your organization.

View File

@ -0,0 +1,8 @@
---
build:
render: never
title: Install
weight: 10
aliases:
- /desktop/install/
---

View File

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 89 KiB

View File

Before

Width:  |  Height:  |  Size: 2.3 KiB

After

Width:  |  Height:  |  Size: 2.3 KiB

View File

@ -10,6 +10,7 @@ weight: 60
aliases:
- /desktop/linux/install/
- /desktop/install/linux-install/
- /desktop/install/linux/
---
> **Docker Desktop terms**
@ -140,7 +141,7 @@ To install Docker Desktop successfully, your Linux host must meet the following
- For many Linux distros, the Gnome environment does not support tray icons. To add support for tray icons, you need to install a Gnome extension. For example, [AppIndicator](https://extensions.gnome.org/extension/615/appindicator-support/).
- At least 4 GB of RAM.
- Enable configuring ID mapping in user namespaces, see [File sharing](/manuals/desktop/faqs/linuxfaqs.md#how-do-i-enable-file-sharing). Note that for Docker Desktop version 4.35 and later, this is not required anymore.
- Recommended: [Initialize `pass`](/manuals/desktop/get-started.md#credentials-management-for-linux-users) for credentials management.
- Recommended: [Initialize `pass`](/manuals/desktop/setup/sign-in.md#credentials-management-for-linux-users) for credentials management.
Docker Desktop for Linux runs a Virtual Machine (VM). For more information on why, see [Why Docker Desktop for Linux runs a VM](/manuals/desktop/faqs/linuxfaqs.md#why-does-docker-desktop-for-linux-run-a-vm).

View File

@ -8,6 +8,7 @@ linkTitle: Arch
aliases:
- /desktop/linux/install/archlinux/
- /desktop/install/archlinux/
- /desktop/install/linux/archlinux/
---
> **Docker Desktop terms**

View File

@ -9,6 +9,7 @@ toc_max: 4
aliases:
- /desktop/linux/install/debian/
- /desktop/install/debian/
- /desktop/install/linux/debian/
---
> **Docker Desktop terms**

View File

@ -9,6 +9,7 @@ toc_max: 4
aliases:
- /desktop/linux/install/fedora/
- /desktop/install/fedora/
- /desktop/install/linux/fedora/
---
> **Docker Desktop terms**

View File

@ -11,6 +11,8 @@ params:
badge:
color: green
text: New
aliases:
- /desktop/install/linux/rhel/
---
> **Docker Desktop terms**

View File

@ -12,6 +12,7 @@ toc_max: 4
aliases:
- /desktop/linux/install/ubuntu/
- /desktop/install/ubuntu/
- /desktop/install/linux/ubuntu/
---
> **Docker Desktop terms**

View File

@ -15,6 +15,7 @@ aliases:
- /docker-for-mac/apple-m1/
- /docker-for-mac/apple-silicon/
- /desktop/mac/apple-silicon/
- /desktop/install/mac-install/
---
> **Docker Desktop terms**
@ -28,7 +29,7 @@ This page contains download URLs, information about system requirements, and ins
{{< button text="Docker Desktop for Mac with Apple silicon" url="https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64" >}}
{{< button text="Docker Desktop for Mac with Intel chip" url="https://desktop.docker.com/mac/main/amd64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-amd64" >}}
*For checksums, see [Release notes](../release-notes.md).*
*For checksums, see [Release notes](/manuals/desktop/release-notes.md).*
## System requirements
@ -53,7 +54,7 @@ This page contains download URLs, information about system requirements, and ins
> Docker supports Docker Desktop on the most recent versions of macOS. That is, the current release of macOS and the previous two releases. As new major versions of macOS are made generally available, Docker stops supporting the oldest version and supports the newest version of macOS (in addition to the previous two releases).
- At least 4 GB of RAM.
- For the best experience, it's recommended that you install Rosetta 2. There is no longer a hard requirement to install Rosetta 2, however there are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See [Known issues](../troubleshoot/known-issues.md). To install Rosetta 2 manually from the command line, run the following command:
- For the best experience, it's recommended that you install Rosetta 2. There is no longer a hard requirement to install Rosetta 2, however there are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See [Known issues](/manuals/desktop/troubleshoot/known-issues.md). To install Rosetta 2 manually from the command line, run the following command:
```console
$ softwareupdate --install-rosetta
@ -69,7 +70,7 @@ This page contains download URLs, information about system requirements, and ins
### Install interactively
1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md).
1. Download the installer using the download buttons at the top of the page, or from the [release notes](/manuals/desktop/release-notes.md).
2. Double-click `Docker.dmg` to open the installer, then drag the Docker icon to the **Applications** folder. By default, Docker Desktop is installed at `/Applications/Docker.app`.
@ -96,7 +97,7 @@ This page contains download URLs, information about system requirements, and ins
### Install from the command line
After downloading `Docker.dmg` from either the download buttons at the top of the page or from the [release notes](../release-notes.md), run the following commands in a terminal to install Docker Desktop in the **Applications** folder:
After downloading `Docker.dmg` from either the download buttons at the top of the page or from the [release notes](/manuals/desktop/release-notes.md), run the following commands in a terminal to install Docker Desktop in the **Applications** folder:
```console
$ sudo hdiutil attach Docker.dmg
@ -109,7 +110,7 @@ By default, Docker Desktop is installed at `/Applications/Docker.app`. As macOS
The `install` command accepts the following flags:
- `--accept-license`: Accepts the [Docker Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement) now, rather than requiring it to be accepted when the application is first run.
- `--allowed-org=<org name>`: Requires the user to sign in and be part of the specified Docker Hub organization when running the application
- `--user=<username>`: Performs the privileged configurations once during installation. This removes the need for the user to grant root privileges on first run. For more information, see [Privileged helper permission requirements](/manuals/desktop/install/mac-permission-requirements.md#permission-requirements). To find the username, enter `ls /Users` in the CLI.
- `--user=<username>`: Performs the privileged configurations once during installation. This removes the need for the user to grant root privileges on first run. For more information, see [Privileged helper permission requirements](/manuals/desktop/setup/install/mac-permission-requirements.md#permission-requirements). To find the username, enter `ls /Users` in the CLI.
- `--admin-settings`: Automatically creates an `admin-settings.json` file which is used by administrators to control certain Docker Desktop settings on client machines within their organization. For more information, see [Settings Management](/manuals/security/for-admins/hardened-desktop/settings-management/_index.md).
- It must be used together with the `--allowed-org=<org name>` flag.
- For example: `--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"`
@ -131,10 +132,10 @@ The `install` command accepts the following flags:
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- [Get started with Docker](/get-started/introduction/_index.md).
- [Explore Docker Desktop](../use-desktop/_index.md) and all its features.
- [Explore Docker Desktop](/manuals/desktop/use-desktop/_index.md) and all its features.
- [Troubleshooting](/manuals/desktop/troubleshoot/_index.md) describes common problems, workarounds, how
to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [Release notes](../release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Back up and restore data](../backup-and-restore.md) provides instructions
- [FAQs](/manuals/desktop/faqs/general.md) provide answers to frequently asked questions.
- [Release notes](/manuals/desktop/release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Back up and restore data](/manuals/desktop/backup-and-restore.md) provides instructions
on backing up and restoring data related to Docker.

View File

@ -7,6 +7,7 @@ aliases:
- /docker-for-mac/privileged-helper/
- /desktop/mac/privileged-helper/
- /desktop/mac/permission-requirements/
- /desktop/install/mac-permission-requirements/
weight: 20
---
@ -134,7 +135,7 @@ On first run, Docker Desktop checks if `localhost` is resolved to `127.0.0.1`. I
## Installing from the command line
In version 4.11 and later of Docker Desktop for Mac, privileged configurations are applied during the installation with the `--user` flag on the [install command](/manuals/desktop/install/mac-install.md#install-from-the-command-line). In this case, you are not prompted to grant root privileges on the first run of Docker Desktop. Specifically, the `--user` flag:
In version 4.11 and later of Docker Desktop for Mac, privileged configurations are applied during the installation with the `--user` flag on the [install command](/manuals/desktop/setup/install/mac-install.md#install-from-the-command-line). In this case, you are not prompted to grant root privileges on the first run of Docker Desktop. Specifically, the `--user` flag:
- Uninstalls the previous `com.docker.vmnetd` if present
- Sets up symlinks
- Ensures that `localhost` is resolved to `127.0.0.1`

View File

@ -4,6 +4,8 @@ linkTitle: Use the MSI installer
weight: 50
description: If you're an IT admin, learn how to deploy Docker Desktop with Microsoft installer
keywords: msi, docker desktop, windows, installation
aliases:
- /desktop/install/msi/
---
> [!NOTE]

View File

@ -3,11 +3,13 @@ title: MSI FAQs
description: Frequently asked questions for deploying Docker Desktop with Microsoft installer
keywords: msi, deploy, docker desktop, faqs
tags: [FAQ]
aliases:
- /desktop/install/msi/faq/
---
### What happens to user data if they have an older Docker Desktop installation (i.e. `.exe`)?
If they have an older `.exe` installation, users must [uninstall](../../uninstall.md) this version before using the new MSI version. This deletes all Docker containers, images, volumes, and other Docker-related data local to the machine, and removes the files generated by the application. For older versions, users should [backup](../../backup-and-restore.md) any containers that they want to keep.
If they have an older `.exe` installation, users must [uninstall](/manuals/desktop/uninstall.md) this version before using the new MSI version. This deletes all Docker containers, images, volumes, and other Docker-related data local to the machine, and removes the files generated by the application. For older versions, users should [backup](/manuals/desktop/backup-and-restore.md) any containers that they want to keep.
For Docker Desktop versions 4.30 and later of the `exe` installer, a `-keep-data` flag is available. It removes Docker Desktop but keeps underlying data, such as the VMs that run containers.

View File

@ -2,6 +2,8 @@
title: Install and configure
description: Understand how to use the MSI installer. Also explore additional configuration options.
keywords: msi, windows, docker desktop, install, deploy, configure
aliases:
- /desktop/install/msi/install-and-configure/
---
## Install interactively

View File

@ -1,7 +1,9 @@
---
title: Use Intune
description: Use Intune, Microsoft's cloud-based device management tool, to deploy Docker Desktop
keywords: microsoft, windows, docker desktop, deploy, mdm, enterprise, administrator,
keywords: microsoft, windows, docker desktop, deploy, mdm, enterprise, administrator
aliases:
- /desktop/install/msi/use-intune/
---
Learn how to deploy Docker Desktop using Intune, Microsoft's cloud-based device management tool.

View File

@ -19,6 +19,7 @@ aliases:
- /install/windows/ee-preview/
- /installation/windows/
- /desktop/win/configuring-wsl/
- /desktop/install/windows-install/
---
> **Docker Desktop terms**
@ -32,7 +33,7 @@ This page contains the download URL, information about system requirements, and
{{< button text="Docker Desktop for Windows - x86_64" url="https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-win-amd64" >}}
{{< button text="Docker Desktop for Windows - Arm (Beta)" url="https://desktop.docker.com/win/main/arm64/Docker%20Desktop%20Installer.exe?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-win-arm64" >}}
_For checksums, see [Release notes](../release-notes.md)_
_For checksums, see [Release notes](/manuals/desktop/release-notes.md)_
## System requirements
@ -55,9 +56,9 @@ _For checksums, see [Release notes](../release-notes.md)_
- 64-bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation)
- 4GB system RAM
- Enable hardware virtualization in BIOS. For more information, see
[Virtualization](../troubleshoot/topics.md#virtualization).
[Virtualization](/manuals/desktop/troubleshoot/topics.md#virtualization).
For more information on setting up WSL 2 with Docker Desktop, see [WSL](../wsl/_index.md).
For more information on setting up WSL 2 with Docker Desktop, see [WSL](/manuals/desktop/wsl/_index.md).
> [!NOTE]
>
@ -81,7 +82,7 @@ For more information on setting up WSL 2 with Docker Desktop, see [WSL](../wsl/_
- 4GB system RAM
- Turn on BIOS-level hardware virtualization support in the
BIOS settings. For more information, see
[Virtualization](../troubleshoot/topics.md#virtualization).
[Virtualization](/manuals/desktop/troubleshoot/topics.md#virtualization).
> [!NOTE]
>
@ -105,7 +106,7 @@ For more information on setting up WSL 2 with Docker Desktop, see [WSL](../wsl/_
- 64-bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation)
- 4GB system RAM
- Enable hardware virtualization in BIOS. For more information, see
[Virtualization](../troubleshoot/topics.md#virtualization).
[Virtualization](/manuals/desktop/troubleshoot/topics.md#virtualization).
> [!IMPORTANT]
>
@ -120,7 +121,7 @@ accounts use the same VM to build and run containers. Note that it is not possib
Running Docker Desktop inside a VMware ESXi or Azure VM is supported for Docker Business customers.
It requires enabling nested virtualization on the hypervisor first.
For more information, see [Running Docker Desktop in a VM or VDI environment](../vm-vdi.md).
For more information, see [Running Docker Desktop in a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md).
{{< accordion title="How do I switch between Windows and Linux containers?" >}}
@ -142,7 +143,7 @@ For more information on Windows containers, refer to the following documentation
[forked here to use containers](https://github.com/friism/MusicStore), is a good example of a multi-container application.
- To understand how to connect to Windows containers from the local host, see
[I want to connect to a container from Windows](../networking.md#i-want-to-connect-to-a-container-from-the-host)
[I want to connect to a container from Windows](/manuals/desktop/networking.md#i-want-to-connect-to-a-container-from-the-host)
> [!NOTE]
>
@ -164,7 +165,7 @@ again when you switch back.
### Install interactively
1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md).
1. Download the installer using the download button at the top of the page, or from the [release notes](/manuals/desktop/release-notes.md).
2. Double-click `Docker Desktop Installer.exe` to run the installer. By default, Docker Desktop is installed at `C:\Program Files\Docker\Docker`.
@ -259,7 +260,7 @@ Docker Desktop does not start automatically after installation. To start Docker
> [!TIP]
>
> As an IT administrator, you can use endpoint management (MDM) software to identify the number of Docker Desktop instances and their versions within your environment. This can provide accurate license reporting, help ensure your machines use the latest version of Docker Desktop, and enable you to [enforce sign-in](../../security/for-admins/enforce-sign-in/_index.md).
> As an IT administrator, you can use endpoint management (MDM) software to identify the number of Docker Desktop instances and their versions within your environment. This can provide accurate license reporting, help ensure your machines use the latest version of Docker Desktop, and enable you to [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md).
> - [Intune](https://learn.microsoft.com/en-us/mem/intune/apps/app-discovered-apps)
> - [Jamf](https://docs.jamf.com/10.25.0/jamf-pro/administrator-guide/Application_Usage.html)
> - [Kandji](https://support.kandji.io/support/solutions/articles/72000559793-view-a-device-application-list)
@ -270,9 +271,9 @@ Docker Desktop does not start automatically after installation. To start Docker
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- [Get started with Docker](/get-started/introduction/_index.md).
- [Explore Docker Desktop](../use-desktop/_index.md) and all its features.
- [Explore Docker Desktop](/manuals/desktop/use-desktop/_index.md) and all its features.
- [Troubleshooting](/manuals/desktop/troubleshoot/_index.md) describes common problems, workarounds, and
how to get support.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [Release notes](../release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Back up and restore data](../backup-and-restore.md) provides instructions on backing up and restoring data related to Docker.
- [FAQs](/manuals/desktop/faqs/general.md) provide answers to frequently asked questions.
- [Release notes](/manuals/desktop/release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Back up and restore data](/manuals/desktop/backup-and-restore.md) provides instructions on backing up and restoring data related to Docker.

View File

@ -5,6 +5,7 @@ title: Understand permission requirements for Windows
aliases:
- /desktop/windows/privileged-helper/
- /desktop/windows/permission-requirements/
- /desktop/install/windows-permission-requirements/
weight: 40
---

View File

@ -5,7 +5,7 @@ keywords: Docker Dashboard, manage, containers, gui, dashboard, images, user man
learning center, guide, sign in
title: Sign in to Docker Desktop
linkTitle: Sign in
weight: 20
weight: 40
aliases:
- /desktop/linux/
- /desktop/linux/index/
@ -27,11 +27,12 @@ aliases:
- /windows/
- /winkit/
- /winkit/getting-started/
- /desktop/get-started/
---
Docker recommends that you authenticate using the **Sign in** option in the top-right corner of the Docker Dashboard.
In large enterprises where admin access is restricted, administrators can [enforce sign-in](../security/for-admins/enforce-sign-in/_index.md).
In large enterprises where admin access is restricted, administrators can [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md).
> [!TIP]
>
@ -41,7 +42,7 @@ In large enterprises where admin access is restricted, administrators can [enfor
- You can access your Docker Hub repositories directly from Docker Desktop.
- Authenticated users also get a higher pull rate limit compared to anonymous users. For example, if you are authenticated, you get 200 pulls per 6 hour period, compared to 100 pulls per 6 hour period per IP address for anonymous users. For more information, see [Download rate limit](../docker-hub/download-rate-limit.md).
- Authenticated users also get a higher pull rate limit compared to anonymous users. For example, if you are authenticated, you get 200 pulls per 6 hour period, compared to 100 pulls per 6 hour period per IP address for anonymous users. For more information, see [Download rate limit](/manuals/docker-hub/download-rate-limit.md).
- Improve your organizations security posture for containerized development by taking advantage of [Hardened Desktop](/manuals/security/for-admins/hardened-desktop/_index.md).
@ -107,6 +108,6 @@ docker.io/molly/privateimage:latest
## What's next?
- [Explore Docker Desktop](use-desktop/_index.md) and its features.
- [Explore Docker Desktop](/manuals/desktop/use-desktop/_index.md) and its features.
- Change your Docker Desktop settings
- [Browse common FAQs](faqs/general.md)
- [Browse common FAQs](/manuals/desktop/faqs/general.md)

View File

@ -3,8 +3,9 @@ description: Instructions on how to enable nested virtualization
keywords: nested virtualization, Docker Desktop, windows, VM, VDI environment
title: Run Docker Desktop for Windows in a VM or VDI environment
aliases:
- /desktop/nested-virtualization/
weight: 140
- /desktop/nested-virtualization/
- /desktop/vm-vdi/
weight: 30
---
In general, we recommend running Docker Desktop natively on either Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured.
@ -17,7 +18,7 @@ To run Docker Desktop in a virtual desktop environment, it is essential nested v
>
> Support for running Docker Desktop on a virtual desktop is available to Docker Business customers, on VMware ESXi or Azure VMs only.
The support available from Docker extends to installing and running Docker Desktop inside the VM, once the nested virtualization is set up correctly. The only hypervisors we have successfully tested are VMware ESXi and Azure, and there is no support for other VMs. For more information on Docker Desktop support, see [Get support](support.md).
The support available from Docker extends to installing and running Docker Desktop inside the VM, once the nested virtualization is set up correctly. The only hypervisors we have successfully tested are VMware ESXi and Azure, and there is no support for other VMs. For more information on Docker Desktop support, see [Get support](/manuals/desktop/support.md).
For troubleshooting problems and intermittent failures that are outside of Docker's control, you should contact your hypervisor vendor. Each hypervisor vendor offers different levels of support. For example, Microsoft supports running nested Hyper-V both on-prem and on Azure, with some version constraints. This may not be the case for VMWare ESXi.

View File

@ -61,7 +61,7 @@ Docker Desktop excludes support for the following types of issues:
>Note
>
> Support for [running Docker Desktop in a VM or VDI environment](vm-vdi.md) is only available to Docker Business customers.
> Support for [running Docker Desktop in a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md) is only available to Docker Business customers.
### What versions are supported?
@ -76,9 +76,9 @@ As a Team, you can get support for Docker Desktop for the number of machines equ
Docker Desktop is available for Mac, Linux, and Windows. The supported version information can be found on the following pages:
* [Mac system requirements](install/mac-install.md#system-requirements)
* [Windows system requirements](install/windows-install.md#system-requirements)
* [Linux system requirements](install/linux/_index.md#system-requirements)
* [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements)
* [Windows system requirements](/manuals/desktop/setup/install/windows-install.md#system-requirements)
* [Linux system requirements](/manuals/desktop/setup/install/linux/_index.md#system-requirements)
### How is personal diagnostic data handled in Docker Desktop?

View File

@ -103,7 +103,7 @@ If not, the command prints `kern.hv_support: 0`.
See also, [Hypervisor Framework
Reference](https://developer.apple.com/library/mac/documentation/DriversKernelHardware/Reference/Hypervisor/)
in the Apple documentation, and Docker Desktop [Mac system requirements](../install/mac-install.md#system-requirements).
in the Apple documentation, and Docker Desktop [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements).
### VPNKit keeps breaking
@ -298,7 +298,7 @@ Performance tab on the Task Manager. Alternatively, you can type 'systeminfo' in
If you manually uninstall Hyper-V, WSL 2 or turn off virtualization,
Docker Desktop cannot start.
To turn on nested virtualization, see [Run Docker Desktop for Windows in a VM or VDI environment](../vm-vdi.md#turn-on-nested-virtualization).
To turn on nested virtualization, see [Run Docker Desktop for Windows in a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md#turn-on-nested-virtualization).
#### Hypervisor enabled at Windows startup
@ -321,7 +321,7 @@ If you are using Hyper-V and you get the following error message when running Do
The Virtual Machine Management Service failed to start the virtual machine 'DockerDesktopVM' because one of the Hyper-V components is not running
```
Try [enabling nested virtualization](../vm-vdi.md#turn-on-nested-virtualization).
Try [enabling nested virtualization](/manuals/desktop/setup/vm-vdi.md#turn-on-nested-virtualization).
### Windows containers and Windows Server

View File

@ -23,7 +23,7 @@ Additionally, with WSL 2, the time required to start a Docker daemon after a col
Before you turn on the Docker Desktop WSL 2 feature, ensure you have:
- At a minimum WSL version 1.1.3.0., but ideally the latest version of WSL to [avoid Docker Desktop not working as expected](best-practices.md).
- Met the Docker Desktop for Windows' [system requirements](https://docs.docker.com/desktop/install/windows-install/#system-requirements).
- Met the Docker Desktop for Windows' [system requirements](/manuals/desktop/setup/install/windows-install.md#system-requirements).
- Installed the WSL 2 feature on Windows. For detailed instructions, refer to the [Microsoft documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
> [!TIP]

View File

@ -37,9 +37,9 @@ This section describes how to install Docker Engine on Linux, also known as
Docker CE. Docker Engine is also available for Windows, macOS, and Linux,
through Docker Desktop. For instructions on how to install Docker Desktop, see:
- [Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md)
- [Docker Desktop for Mac (macOS)](/manuals/desktop/install/mac-install.md)
- [Docker Desktop for Windows](/manuals/desktop/install/windows-install.md)
- [Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md)
- [Docker Desktop for Mac (macOS)](/manuals/desktop/setup/install/mac-install.md)
- [Docker Desktop for Windows](/manuals/desktop/setup/install/windows-install.md)
## Supported platforms

View File

@ -86,7 +86,7 @@ clean installation, and prefer to clean up any existing data, read the
You can install Docker Engine in different ways, depending on your needs:
- Docker Engine comes bundled with
[Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md). This is
[Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md). This is
the easiest and quickest way to get started.
- Set up and install Docker Engine from

View File

@ -87,7 +87,7 @@ clean installation, and prefer to clean up any existing data, read the
You can install Docker Engine in different ways, depending on your needs:
- Docker Engine comes bundled with
[Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md). This is
[Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md). This is
the easiest and quickest way to get started.
- Set up and install Docker Engine from

View File

@ -96,7 +96,7 @@ clean installation, and prefer to clean up any existing data, read the
You can install Docker Engine in different ways, depending on your needs:
- Docker Engine comes bundled with
[Docker Desktop for Linux](/manuals/desktop/install/linux/_index.md). This is
[Docker Desktop for Linux](/manuals/desktop/setup/install/linux/_index.md). This is
the easiest and quickest way to get started.
- Set up and install Docker Engine from

View File

@ -66,7 +66,7 @@ without it and the feature will take effect. Enforcing sign-in guarantees the
feature always takes effect.
Next, you must either manually [create and configure the admin-settings.json file](configure.md), or use the `--admin-settings` installer flag on [macOS](/manuals/desktop/install/mac-install.md#install-from-the-command-line) or [Windows](/manuals/desktop/install/windows-install.md#install-from-the-command-line) to automatically create the `admin-settings.json` and save it in the correct location.
Next, you must either manually [create and configure the admin-settings.json file](configure.md), or use the `--admin-settings` installer flag on [macOS](/manuals/desktop/setup/install/mac-install.md#install-from-the-command-line) or [Windows](/manuals/desktop/setup/install/windows-install.md#install-from-the-command-line) to automatically create the `admin-settings.json` and save it in the correct location.
Once this is done, Docker Desktop developers receive the changed settings when they either:
- Quit, re-launch, and sign in to Docker Desktop

View File

@ -30,7 +30,7 @@ Settings Management is designed specifically for organizations who dont give
### Step one: Create the `admin-settings.json` file and save it in the correct location
You can either use the `--admin-settings` installer flag on [macOS](/manuals/desktop/install/mac-install.md#install-from-the-command-line) or [Windows](/manuals/desktop/install/windows-install.md#install-from-the-command-line) to automatically create the `admin-settings.json` and save it in the correct location, or set it up manually.
You can either use the `--admin-settings` installer flag on [macOS](/manuals/desktop/setup/install/mac-install.md#install-from-the-command-line) or [Windows](/manuals/desktop/setup/install/windows-install.md#install-from-the-command-line) to automatically create the `admin-settings.json` and save it in the correct location, or set it up manually.
To set it up manually:
1. Create a new, empty JSON file and name it `admin-settings.json`.

View File

@ -111,7 +111,7 @@ _The issue has been fixed in Moby >= v25.0.2 and >= v24.0.9._
Docker Desktop v4.27.0 and earlier are affected. Docker Desktop v4.27.1 was released on February 1 and includes runc, BuildKit, and dockerd binaries patches. In addition to updating to this new version, we encourage all Docker users to diligently use Docker images and Dockerfiles and ensure you only use trusted content in your builds.
As always, you should check Docker Desktop system requirements for your operating system ([Windows](/manuals/desktop/install/windows-install.md#system-requirements), [Linux](/manuals/desktop/install/linux/_index.md#general-system-requirements), [Mac](/manuals/desktop/install/mac-install.md#system-requirements)) before updating to ensure full compatibility.
As always, you should check Docker Desktop system requirements for your operating system ([Windows](/manuals/desktop/setup/install/windows-install.md#system-requirements), [Linux](/manuals/desktop/setup/install/linux/_index.md#general-system-requirements), [Mac](/manuals/desktop/setup/install/mac-install.md#system-requirements)) before updating to ensure full compatibility.
#### Docker Build Cloud

View File

@ -42,7 +42,7 @@ If you have a paid Docker subscription, you can get support for the following ty
For Windows users, you can also request support on:
* Turning on virtualization in BIOS
* Turning on Windows features
* Running inside [certain VM or VDI environments](/manuals/desktop/vm-vdi.md) (Docker Business customers only)
* Running inside [certain VM or VDI environments](/manuals/desktop/setup/vm-vdi.md) (Docker Business customers only)
## What is not supported?
@ -81,9 +81,9 @@ As a Team user, you can get support for Docker Desktop for the number of machine
Docker Desktop is available for Mac, Linux, and Windows. The supported version information can be found on the following pages:
* [Mac system requirements](/manuals/desktop/install/mac-install.md#system-requirements)
* [Windows system requirements](/manuals/desktop/install/windows-install.md#system-requirements)
* [Linux system requirements](/manuals/desktop/install/linux/_index.md#system-requirements)
* [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements)
* [Windows system requirements](/manuals/desktop/setup/install/windows-install.md#system-requirements)
* [Linux system requirements](/manuals/desktop/setup/install/linux/_index.md#system-requirements)
## How is personal diagnostic data handled in Docker Desktop?