diff --git a/content/get-started/get-docker.md b/content/get-started/get-docker.md index 321ea0dff90c..508c00f3ee9f 100644 --- a/content/get-started/get-docker.md +++ b/content/get-started/get-docker.md @@ -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" >}}
@@ -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" >}}
diff --git a/content/get-started/introduction/get-docker-desktop.md b/content/get-started/introduction/get-docker-desktop.md index eb796ff0fb49..5411cd61ac48 100644 --- a/content/get-started/introduction/get-docker-desktop.md +++ b/content/get-started/introduction/get-docker-desktop.md @@ -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" >}}
{{< 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" >}}
diff --git a/content/guides/rust/develop.md b/content/guides/rust/develop.md index d1baae4c19b2..462fc229deb2 100644 --- a/content/guides/rust/develop.md +++ b/content/guides/rust/develop.md @@ -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 diff --git a/content/manuals/compose/install/_index.md b/content/manuals/compose/install/_index.md index f96f7a9f847b..e7fcac65bc40 100644 --- a/content/manuals/compose/install/_index.md +++ b/content/manuals/compose/install/_index.md @@ -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" >}}. diff --git a/content/manuals/compose/releases/release-notes.md b/content/manuals/compose/releases/release-notes.md index ccf4f263a7a8..35d3394a9935 100644 --- a/content/manuals/compose/releases/release-notes.md +++ b/content/manuals/compose/releases/release-notes.md @@ -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. diff --git a/content/manuals/desktop/_index.md b/content/manuals/desktop/_index.md index cb1957d25e62..d67586b7fbd8 100644 --- a/content/manuals/desktop/_index.md +++ b/content/manuals/desktop/_index.md @@ -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 diff --git a/content/manuals/desktop/previous-versions/2.x-windows.md b/content/manuals/desktop/previous-versions/2.x-windows.md index 3db8701020ad..abf996db836e 100644 --- a/content/manuals/desktop/previous-versions/2.x-windows.md +++ b/content/manuals/desktop/previous-versions/2.x-windows.md @@ -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. diff --git a/content/manuals/desktop/previous-versions/3.x-mac.md b/content/manuals/desktop/previous-versions/3.x-mac.md index 1dfddfc554fc..25491a7e57a1 100644 --- a/content/manuals/desktop/previous-versions/3.x-mac.md +++ b/content/manuals/desktop/previous-versions/3.x-mac.md @@ -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 diff --git a/content/manuals/desktop/previous-versions/edge-releases-mac.md b/content/manuals/desktop/previous-versions/edge-releases-mac.md index 0a17922e4752..303bdcb61779 100644 --- a/content/manuals/desktop/previous-versions/edge-releases-mac.md +++ b/content/manuals/desktop/previous-versions/edge-releases-mac.md @@ -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** diff --git a/content/manuals/desktop/previous-versions/edge-releases-windows.md b/content/manuals/desktop/previous-versions/edge-releases-windows.md index 537b2b5d0bee..cb41eb8b2db1 100644 --- a/content/manuals/desktop/previous-versions/edge-releases-windows.md +++ b/content/manuals/desktop/previous-versions/edge-releases-windows.md @@ -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. diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index 7656dbbcc272..0366ecac532e 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -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/) diff --git a/content/manuals/desktop/settings.md b/content/manuals/desktop/settings.md index b508546d0e2e..7f0118856733 100644 --- a/content/manuals/desktop/settings.md +++ b/content/manuals/desktop/settings.md @@ -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). diff --git a/content/manuals/desktop/install/_index.md b/content/manuals/desktop/setup/_index.md similarity index 66% rename from content/manuals/desktop/install/_index.md rename to content/manuals/desktop/setup/_index.md index 186d97b05dd3..676f6ca7c187 100644 --- a/content/manuals/desktop/install/_index.md +++ b/content/manuals/desktop/setup/_index.md @@ -1,6 +1,6 @@ --- build: render: never -title: Install +title: Setup weight: 10 ---- +--- \ No newline at end of file diff --git a/content/manuals/desktop/allow-list.md b/content/manuals/desktop/setup/allow-list.md similarity index 95% rename from content/manuals/desktop/allow-list.md rename to content/manuals/desktop/setup/allow-list.md index 8c859a8d04bc..78b7ea3e6a41 100644 --- a/content/manuals/desktop/allow-list.md +++ b/content/manuals/desktop/setup/allow-list.md @@ -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. diff --git a/content/manuals/desktop/setup/install/_index.md b/content/manuals/desktop/setup/install/_index.md new file mode 100644 index 000000000000..3b6650ef5cdf --- /dev/null +++ b/content/manuals/desktop/setup/install/_index.md @@ -0,0 +1,8 @@ +--- +build: + render: never +title: Install +weight: 10 +aliases: +- /desktop/install/ +--- diff --git a/content/manuals/desktop/install/images/docker-app-in-apps.png b/content/manuals/desktop/setup/install/images/docker-app-in-apps.png similarity index 100% rename from content/manuals/desktop/install/images/docker-app-in-apps.png rename to content/manuals/desktop/setup/install/images/docker-app-in-apps.png diff --git a/content/manuals/desktop/install/images/whale-x.svg b/content/manuals/desktop/setup/install/images/whale-x.svg similarity index 100% rename from content/manuals/desktop/install/images/whale-x.svg rename to content/manuals/desktop/setup/install/images/whale-x.svg diff --git a/content/manuals/desktop/install/linux/_index.md b/content/manuals/desktop/setup/install/linux/_index.md similarity index 98% rename from content/manuals/desktop/install/linux/_index.md rename to content/manuals/desktop/setup/install/linux/_index.md index b6c364d70aa1..54f425661f60 100644 --- a/content/manuals/desktop/install/linux/_index.md +++ b/content/manuals/desktop/setup/install/linux/_index.md @@ -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). diff --git a/content/manuals/desktop/install/linux/archlinux.md b/content/manuals/desktop/setup/install/linux/archlinux.md similarity index 98% rename from content/manuals/desktop/install/linux/archlinux.md rename to content/manuals/desktop/setup/install/linux/archlinux.md index 214036ed504b..d80930d69031 100644 --- a/content/manuals/desktop/install/linux/archlinux.md +++ b/content/manuals/desktop/setup/install/linux/archlinux.md @@ -8,6 +8,7 @@ linkTitle: Arch aliases: - /desktop/linux/install/archlinux/ - /desktop/install/archlinux/ +- /desktop/install/linux/archlinux/ --- > **Docker Desktop terms** diff --git a/content/manuals/desktop/install/linux/debian.md b/content/manuals/desktop/setup/install/linux/debian.md similarity index 99% rename from content/manuals/desktop/install/linux/debian.md rename to content/manuals/desktop/setup/install/linux/debian.md index be1642eb3026..0185a890d654 100644 --- a/content/manuals/desktop/install/linux/debian.md +++ b/content/manuals/desktop/setup/install/linux/debian.md @@ -9,6 +9,7 @@ toc_max: 4 aliases: - /desktop/linux/install/debian/ - /desktop/install/debian/ +- /desktop/install/linux/debian/ --- > **Docker Desktop terms** diff --git a/content/manuals/desktop/install/linux/fedora.md b/content/manuals/desktop/setup/install/linux/fedora.md similarity index 99% rename from content/manuals/desktop/install/linux/fedora.md rename to content/manuals/desktop/setup/install/linux/fedora.md index 9dc03aba71b4..a5d488792126 100644 --- a/content/manuals/desktop/install/linux/fedora.md +++ b/content/manuals/desktop/setup/install/linux/fedora.md @@ -9,6 +9,7 @@ toc_max: 4 aliases: - /desktop/linux/install/fedora/ - /desktop/install/fedora/ +- /desktop/install/linux/fedora/ --- > **Docker Desktop terms** diff --git a/content/manuals/desktop/install/linux/rhel.md b/content/manuals/desktop/setup/install/linux/rhel.md similarity index 99% rename from content/manuals/desktop/install/linux/rhel.md rename to content/manuals/desktop/setup/install/linux/rhel.md index 5fdba5ea02e4..b3c9b0dbe6f4 100644 --- a/content/manuals/desktop/install/linux/rhel.md +++ b/content/manuals/desktop/setup/install/linux/rhel.md @@ -11,6 +11,8 @@ params: badge: color: green text: New +aliases: +- /desktop/install/linux/rhel/ --- > **Docker Desktop terms** diff --git a/content/manuals/desktop/install/linux/ubuntu.md b/content/manuals/desktop/setup/install/linux/ubuntu.md similarity index 99% rename from content/manuals/desktop/install/linux/ubuntu.md rename to content/manuals/desktop/setup/install/linux/ubuntu.md index 1a6f3ed846c9..946df8393fa9 100644 --- a/content/manuals/desktop/install/linux/ubuntu.md +++ b/content/manuals/desktop/setup/install/linux/ubuntu.md @@ -12,6 +12,7 @@ toc_max: 4 aliases: - /desktop/linux/install/ubuntu/ - /desktop/install/ubuntu/ +- /desktop/install/linux/ubuntu/ --- > **Docker Desktop terms** diff --git a/content/manuals/desktop/install/mac-install.md b/content/manuals/desktop/setup/install/mac-install.md similarity index 88% rename from content/manuals/desktop/install/mac-install.md rename to content/manuals/desktop/setup/install/mac-install.md index 224699718577..911a2b699ddc 100644 --- a/content/manuals/desktop/install/mac-install.md +++ b/content/manuals/desktop/setup/install/mac-install.md @@ -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=`: Requires the user to sign in and be part of the specified Docker Hub organization when running the application -- `--user=`: 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=`: 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=` flag. - For example: `--allowed-org= --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. diff --git a/content/manuals/desktop/install/mac-permission-requirements.md b/content/manuals/desktop/setup/install/mac-permission-requirements.md similarity index 97% rename from content/manuals/desktop/install/mac-permission-requirements.md rename to content/manuals/desktop/setup/install/mac-permission-requirements.md index 9f039a0ebcb6..998c77923c11 100644 --- a/content/manuals/desktop/install/mac-permission-requirements.md +++ b/content/manuals/desktop/setup/install/mac-permission-requirements.md @@ -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` diff --git a/content/manuals/desktop/install/msi/_index.md b/content/manuals/desktop/setup/install/msi/_index.md similarity index 97% rename from content/manuals/desktop/install/msi/_index.md rename to content/manuals/desktop/setup/install/msi/_index.md index 9cdb5cbc360c..7214ed45966c 100644 --- a/content/manuals/desktop/install/msi/_index.md +++ b/content/manuals/desktop/setup/install/msi/_index.md @@ -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] diff --git a/content/manuals/desktop/install/msi/faq.md b/content/manuals/desktop/setup/install/msi/faq.md similarity index 89% rename from content/manuals/desktop/install/msi/faq.md rename to content/manuals/desktop/setup/install/msi/faq.md index 94565b4c8e6f..aad224804c35 100644 --- a/content/manuals/desktop/install/msi/faq.md +++ b/content/manuals/desktop/setup/install/msi/faq.md @@ -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. diff --git a/content/manuals/desktop/install/msi/install-and-configure.md b/content/manuals/desktop/setup/install/msi/install-and-configure.md similarity index 99% rename from content/manuals/desktop/install/msi/install-and-configure.md rename to content/manuals/desktop/setup/install/msi/install-and-configure.md index f96de559fd13..fe07e03f83d8 100644 --- a/content/manuals/desktop/install/msi/install-and-configure.md +++ b/content/manuals/desktop/setup/install/msi/install-and-configure.md @@ -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 diff --git a/content/manuals/desktop/install/msi/use-intune.md b/content/manuals/desktop/setup/install/msi/use-intune.md similarity index 95% rename from content/manuals/desktop/install/msi/use-intune.md rename to content/manuals/desktop/setup/install/msi/use-intune.md index 1e9fdda03b72..38c6a31d158b 100644 --- a/content/manuals/desktop/install/msi/use-intune.md +++ b/content/manuals/desktop/setup/install/msi/use-intune.md @@ -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. diff --git a/content/manuals/desktop/install/windows-install.md b/content/manuals/desktop/setup/install/windows-install.md similarity index 92% rename from content/manuals/desktop/install/windows-install.md rename to content/manuals/desktop/setup/install/windows-install.md index d7e733e13479..9a23b86823f8 100644 --- a/content/manuals/desktop/install/windows-install.md +++ b/content/manuals/desktop/setup/install/windows-install.md @@ -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. diff --git a/content/manuals/desktop/install/windows-permission-requirements.md b/content/manuals/desktop/setup/install/windows-permission-requirements.md similarity index 99% rename from content/manuals/desktop/install/windows-permission-requirements.md rename to content/manuals/desktop/setup/install/windows-permission-requirements.md index d3c27d4c8b5b..aded11b07d40 100644 --- a/content/manuals/desktop/install/windows-permission-requirements.md +++ b/content/manuals/desktop/setup/install/windows-permission-requirements.md @@ -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 --- diff --git a/content/manuals/desktop/get-started.md b/content/manuals/desktop/setup/sign-in.md similarity index 91% rename from content/manuals/desktop/get-started.md rename to content/manuals/desktop/setup/sign-in.md index 77012a569bab..ff1bb2053e3d 100644 --- a/content/manuals/desktop/get-started.md +++ b/content/manuals/desktop/setup/sign-in.md @@ -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 organization’s 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) diff --git a/content/manuals/desktop/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md similarity index 96% rename from content/manuals/desktop/vm-vdi.md rename to content/manuals/desktop/setup/vm-vdi.md index bf18e97c0c00..9d07b06b759b 100644 --- a/content/manuals/desktop/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -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. diff --git a/content/manuals/desktop/support.md b/content/manuals/desktop/support.md index da98960154cc..d1d4df233075 100644 --- a/content/manuals/desktop/support.md +++ b/content/manuals/desktop/support.md @@ -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? diff --git a/content/manuals/desktop/troubleshoot/topics.md b/content/manuals/desktop/troubleshoot/topics.md index 03295f3b299a..634574ad681d 100644 --- a/content/manuals/desktop/troubleshoot/topics.md +++ b/content/manuals/desktop/troubleshoot/topics.md @@ -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 diff --git a/content/manuals/desktop/wsl/_index.md b/content/manuals/desktop/wsl/_index.md index 40e22fad773a..fd6e4d81ff2a 100644 --- a/content/manuals/desktop/wsl/_index.md +++ b/content/manuals/desktop/wsl/_index.md @@ -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] diff --git a/content/manuals/engine/install/_index.md b/content/manuals/engine/install/_index.md index b67dbdef795d..58d73fc6f163 100644 --- a/content/manuals/engine/install/_index.md +++ b/content/manuals/engine/install/_index.md @@ -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 diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md index 47f635399a90..71c464516d61 100644 --- a/content/manuals/engine/install/debian.md +++ b/content/manuals/engine/install/debian.md @@ -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 diff --git a/content/manuals/engine/install/raspberry-pi-os.md b/content/manuals/engine/install/raspberry-pi-os.md index f9e5b2d7d010..3d2aa680d4e3 100644 --- a/content/manuals/engine/install/raspberry-pi-os.md +++ b/content/manuals/engine/install/raspberry-pi-os.md @@ -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 diff --git a/content/manuals/engine/install/ubuntu.md b/content/manuals/engine/install/ubuntu.md index 295bc5c1f7cb..68665f1ab024 100644 --- a/content/manuals/engine/install/ubuntu.md +++ b/content/manuals/engine/install/ubuntu.md @@ -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 diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/_index.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/_index.md index 03cd8324bf10..a9807becaca8 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/_index.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/_index.md @@ -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 diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/configure.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/configure.md index 01e34698c583..82e452c7e78f 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/configure.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/configure.md @@ -30,7 +30,7 @@ Settings Management is designed specifically for organizations who don’t 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`. diff --git a/content/manuals/security/security-announcements.md b/content/manuals/security/security-announcements.md index ddabcc750816..f98c6c0dbe52 100644 --- a/content/manuals/security/security-announcements.md +++ b/content/manuals/security/security-announcements.md @@ -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 diff --git a/content/manuals/support.md b/content/manuals/support.md index afad26228d5f..571278a25d05 100644 --- a/content/manuals/support.md +++ b/content/manuals/support.md @@ -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?