Engdocs 802b (#15108)

* moved install pages

* moved images

* update toc

* add redirects

* ammend page links

* fix broken links

* fix broken links

* fix broken links

* fix broken links
This commit is contained in:
Allie Sadler 2022-07-13 10:41:56 +01:00 committed by GitHub
parent 39abb0fe1d
commit 38fec0d159
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
42 changed files with 143 additions and 130 deletions

View File

@ -1137,10 +1137,26 @@ manuals:
section:
- path: /desktop/
title: Overview
- sectiontitle: Install Docker Desktop
section:
- path: /desktop/install/mac-install/
title: Install on Mac
- path: /desktop/install/windows-install/
title: Install on Windows
- path: /desktop/install/linux-install/
title: Insall on Linux
- sectiontitle: Installation per Linux distro
section:
- path: /desktop/install/debian/
title: Install on Debian
- path: /desktop/install/fedora/
title: Install on Fedora
- path: /desktop/install/ubuntu/
title: Install on Ubuntu
- path: /desktop/install/archlinux/
title: Install on Arch
- sectiontitle: Mac
section:
- path: /desktop/mac/install/
title: Install Docker Desktop for Mac
- path: /desktop/mac/
title: User manual
- path: /desktop/mac/troubleshoot/
@ -1151,8 +1167,6 @@ manuals:
title: Privileged Helper
- sectiontitle: Windows
section:
- path: /desktop/windows/install/
title: Install Docker Desktop for Windows
- path: /desktop/windows/
title: User manual
- path: /desktop/windows/troubleshoot/
@ -1161,18 +1175,6 @@ manuals:
title: Docker Desktop WSL 2 backend
- sectiontitle: Linux
section:
- path: /desktop/linux/install/
title: Install Docker Desktop for Linux
- sectiontitle: Installation per distro
section:
- path: /desktop/linux/install/debian/
title: Install on Debian
- path: /desktop/linux/install/fedora/
title: Install on Fedora
- path: /desktop/linux/install/ubuntu/
title: Install on Ubuntu
- path: /desktop/linux/install/archlinux/
title: Install on Arch
- path: /desktop/linux/
title: User manual
- path: /desktop/linux/troubleshoot/

View File

@ -2,7 +2,7 @@
When an update is available, Docker Desktop displays an icon on the Docker menu to indicate the availability of a newer version. Additionally, the **Software Updates** section in **Settings** (**Preferences** on Mac) also notifies you of any updates available to Docker Desktop. You can choose to download the update right away, or click the **Release Notes** option to learn what's included in the updated version.
Starting with Docker Desktop 4.2.0, the option to turn off the automatic check for updates is available for users on all Docker subscriptions, including Docker Personal and Docker Pro. For more information, see [Software Updates](../#software-updates).
Starting with Docker Desktop 4.2.0, the option to turn off the automatic check for updates is available for users on all Docker subscriptions, including Docker Personal and Docker Pro..
> **Docker Subscription Service Agreement**
>

View File

@ -204,7 +204,7 @@
</a>
</p>
<p class="only-win">
<a href="/desktop/windows/install/#system-requirements">
<a href="/desktop/install/windows-install/#system-requirements">
What are the system requirements for Docker Desktop?
</a>
</p>
@ -214,7 +214,7 @@
</a>
</p>
<p class="only-mac">
<a href="/desktop/mac/install/#system-requirements">
<a href="/desktop/install/mac-install/#system-requirements">
What are the system requirements for Docker Desktop?
</a>
</p>
@ -232,7 +232,7 @@
<div class="col-xs-12 col-md-4 col-lg-5">
<h6>Popular articles</h6>
<p class="only-win"><a href="/desktop/windows/wsl/">Docker Desktop WSL 2 backend</a></p>
<p class="only-mac"><a href="/desktop/mac/install/">Install Docker Desktop on Mac</a></p>
<p class="only-mac"><a href="/desktop/install/mac-install/">Install Docker Desktop on Mac</a></p>
<p><a href="/desktop/dashboard/">Docker Desktop Dashboard</a></p>
<p class="only-win"><a href="/desktop/kubernetes/">Deploy on Kubernetes</a></p>
<p class="only-win"><a href="/desktop/windows/release-notes/">Release notes</a></p>

View File

@ -26,8 +26,8 @@ To deploy Docker containers on Azure, you must meet the following requirements:
1. Download and install the latest version of Docker Desktop.
- [Download for Mac](../desktop/mac/install.md)
- [Download for Windows](../desktop/windows/install.md)
- [Download for Mac](../desktop/install/mac-install.md)
- [Download for Windows](../desktop/install/windows-install.md)
Alternatively, install the [Docker Compose CLI for Linux](#install-the-docker-compose-cli-on-linux).

View File

@ -25,8 +25,8 @@ To deploy Docker containers on ECS, you must meet the following requirements:
1. Download and install the latest version of Docker Desktop.
- [Download for Mac](../desktop/mac/install.md)
- [Download for Windows](../desktop/windows/install.md)
- [Download for Mac](../desktop/install/mac-install.md)
- [Download for Windows](../desktop/install/windows-install.md)
Alternatively, install the [Docker Compose CLI for Linux](#install-the-docker-compose-cli-on-linux).

View File

@ -279,7 +279,7 @@ for Mac, and the general examples on how to
>
> * If you are using Oracle VirtualBox on an older Windows OS, you might encounter an issue with shared folders as described in this [VB trouble
ticket](https://www.virtualbox.org/ticket/14920). Newer Windows systems meet the
requirements for [Docker Desktop for Windows](../desktop/windows/install.md) and do not
requirements for [Docker Desktop for Windows](../desktop/install/windows-install.md) and do not
need VirtualBox.
{: .important}

View File

@ -13,9 +13,9 @@ Check a list of what's shipped with Docker Desktop and a list of key features in
Docker Desktop is available for Mac, Windows, and Linux.
For download information, system requirements, and installation instructions, see:
* [Docker Desktop for Linux](../../desktop/linux/install.md){:target="_blank" rel="noopener" class="_"}
* [Docker Desktop for Mac](../../desktop/mac/install.md){:target="_blank" rel="noopener" class="_"}
* [Docker Desktop for Windows](../../desktop/windows/install.md){:target="_blank" rel="noopener" class="_"}
* [Docker Desktop for Linux](../../desktop/install/linux-install.md){:target="_blank" rel="noopener" class="_"}
* [Docker Desktop for Mac](../../desktop/install/mac-install.md){:target="_blank" rel="noopener" class="_"}
* [Docker Desktop for Windows](../../desktop/install/windows-install.md){:target="_blank" rel="noopener" class="_"}
For information about Docker Desktop licensing, see [Docker Desktop License Agreement](../../subscription/index.md#docker-desktop-license-agreement){:target="_blank" rel="noopener" class="_"}.

View File

@ -15,8 +15,8 @@ In this section, you can find various methods for installing Compose on Linux.
### Installation methods
* [Installing Docker Desktop for Linux](../../desktop/linux/install.md/){:target="_blank" rel="noopener" class="_"} is the easiest and recommended installation route.
Check the Desktop for Linux [supported platforms](../../desktop/linux/install.md/#supported-platforms){:target="_blank" rel="noopener" class="_"} page to verify the supported Linux distributions and architectures.
* [Installing Docker Desktop for Linux](../../desktop/install/linux-install.md/){:target="_blank" rel="noopener" class="_"} is the easiest and recommended installation route.
Check the Desktop for Linux [supported platforms](../../desktop/install/linux-install.md/#supported-platforms){:target="_blank" rel="noopener" class="_"} page to verify the supported Linux distributions and architectures.
The following other methods are possible:

View File

@ -15,9 +15,9 @@ If you want to uninstall Compose and you have installed Docker Desktop, follow t
> Note that, unless you have other Docker instances installed on that specific environment, you would be removing Docker altogether by uninstalling the Desktop.
See Uninstall Docker Desktop for:
* [Mac](../../desktop/mac/install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
* [Windows](../../desktop/windows/install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
* [Linux](../../desktop/linux/install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
* [Mac](../../desktop/install/mac-install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
* [Windows](../../desktop/install/windows-install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
* [Linux](../../desktop/install/linux-install.md/#uninstall-docker-desktop){:target="_blank" rel="noopener" class="_"}
### Uninstalling the Docker Compose CLI plugin

View File

@ -2604,7 +2604,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](../desktop/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](../desktop/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

@ -12,9 +12,9 @@ title: Frequently asked questions
### What are the system requirements for Docker Desktop?
For information about Docker Desktop system requirements, see:
- [Mac system requirements](../mac/install.md#system-requirements)
- [Windows system requirements](../windows/install.md#system-requirements)
- [Linux system requirements](../linux/install.md#system-requirements)
- [Mac system requirements](../install/mac-install.md#system-requirements)
- [Windows system requirements](../install/windows-install.md#system-requirements)
- [Linux system requirements](../install/linux-install.md#system-requirements)
### Where does Docker Desktop get installed on my machine?
@ -42,7 +42,7 @@ cannot access features that require an active internet
connection. Additionally, any functionality that requires you to sign won't work while using Docker Desktop offline or in air-gapped environments.
This includes:
- The in-app [Quick Start Guide](../mac/install.md#quick-start-guide)
- The in-app [Quick Start Guide](../install/mac-install.md#quick-start-guide)
- Pulling or pushing an image to Docker Hub
- [Image Access Management](../../docker-hub/image-access-management.md)
- [Vulnerability scanning](../../docker-hub/vulnerability-scanning.md)
@ -54,7 +54,7 @@ This includes:
[ACI](../../cloud/aci-integration.md) and [ECS](../../cloud/ecs-integration.md)
integrations
- [Kubernetes](../kubernetes.md) (Images are download when you enable Kubernetes for the first time)
- [Check for updates](../mac/install.md#updates) (manual and automatic)
- [Check for updates](../install/mac-install.md#updates) (manual and automatic)
- [In-app diagnostics](../mac/troubleshoot.md#diagnose-and-feedback) (including the [Self-diagnose tool](../mac/troubleshoot.md#self-diagnose-tool))
- Tip of the week
- Sending usage statistics

View File

@ -50,9 +50,9 @@ using a secure repository.
Docker Desktop is available for Mac, Linux, and Windows. For download information, system requirements, and installation instructions, see:
* [Install Docker Desktop on Linux](linux/install.md)
* [Install Docker Desktop on Mac](mac/install.md)
* [Install Docker Desktop on Windows](windows/install.md)
* [Install Docker Desktop on Linux](install/linux-install.md)
* [Install Docker Desktop on Mac](install/mac-install.md)
* [Install Docker Desktop on Windows](install/windows-install.md)
For information about Docker Desktop licensing, see [Docker Desktop License Agreement](../subscription/index.md#docker-desktop-license-agreement).

View File

@ -2,6 +2,8 @@
description: Instructions for installing Docker Desktop Arch package. Mostly meant for hackers who want to try out Docker Desktop on a variety of Arch-based distributions.
keywords: Arch Linux, install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
title: Install Docker Desktop on Arch-based distributions
redirect_from:
- /desktop/linux/install/archlinux/
---
This topic discusses installation of Docker Desktop from an [Arch package](https://desktop-stage.docker.com/linux/main/amd64/78459/docker-desktop-4.8.0-x86_64.pkg.tar.zst?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64) that Docker provides in addition to the supported platforms. Docker has not tested or verified the installation.
@ -9,7 +11,7 @@ This topic discusses installation of Docker Desktop from an [Arch package](https
## Prerequisites
To install Docker Desktop successfully, you must meet the [system requirements](../install.md#system-requirements).
To install Docker Desktop successfully, you must meet the [system requirements](linux-install.md#system-requirements).
Additionally, for non-Gnome Desktop environments, `gnome-terminal` must be installed:
@ -22,10 +24,10 @@ $ sudo pacman -S gnome-terminal
1. Install client binaries. Docker does not have an Arch package repository. Binaries not included in the package must be installed manually before installing Docker Desktop.
2. [Install Docker client binary on Linux](../../../engine/install/binaries.md#install-daemon-and-client-binaries-on-linux). On Arch-based distributions, users must install the Docker client binary.
2. [Install Docker client binary on Linux](../../engine/install/binaries.md#install-daemon-and-client-binaries-on-linux). On Arch-based distributions, users must install the Docker client binary.
Static binaries for the Docker client are available for Linux (as `docker`).
3. Download the Arch package from the [release](../release-notes/index.md) page.
3. Download the Arch package from the [release](../release-notes.md) page.
4. Install the package:
@ -61,5 +63,5 @@ Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/conf
## Next steps
- Take a look at the [Get started](../../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../../develop/index.md) to learn how to build new applications using Docker.
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

View File

@ -3,6 +3,8 @@ description: Instructions for installing Docker Desktop on Debian
keywords: debian, install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
title: Install Docker Desktop on Debian
toc_max: 4
redirect_from:
- /desktop/linux/install/debian/
---
This page contains information on how to install, launch, and upgrade Docker Desktop on a Debian distribution.
@ -10,7 +12,7 @@ This page contains information on how to install, launch, and upgrade Docker Des
## Prerequisites
To install Docker Desktop successfully, you must:
- Meet the [system requirements](../install.md#system-requirements).
- Meet the [system requirements](linux-install.md#system-requirements).
- Have a 64-bit version of Debian 11.
- Uninstall the tech preview or beta version of Docker Desktop for Linux. Run:
@ -45,9 +47,9 @@ $ sudo apt install gnome-terminal
Recommended approach to install Docker Desktop on Debian:
1. Set up [Docker's package repository](../../../engine/install/debian.md#set-up-the-repository).
1. Set up [Docker's package repository](../../engine/install/debian.md#set-up-the-repository).
2. Download latest DEB package from the [release](../release-notes/index.md) page.
2. Download latest DEB package from the [release](../release-notes.md) page.
3. Install the package with apt as follows:
@ -109,5 +111,5 @@ Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/conf
## Next steps
- Take a look at the [Get started](../../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../../develop/index.md) to learn how to build new applications using Docker.
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

View File

@ -3,6 +3,8 @@ description: Instructions for installing Docker Desktop on Fedora
keywords: fedora, rpm, update install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
title: Install Docker Desktop on Fedora
toc_max: 4
redirect_from:
- /desktop/linux/install/fedora/
---
This page contains information on how to install, launch and upgrade Docker Desktop on a Fedora distribution.
@ -10,7 +12,7 @@ This page contains information on how to install, launch and upgrade Docker Desk
## Prerequisites
To install Docker Desktop successfully, you must:
- Meet the [system requirements](../install.md#system-requirements).
- Meet the [system requirements](linux-install.md#system-requirements).
- Have a 64-bit version of either Fedora 35 or Fedora 36.
Additionally, for a Gnome Desktop environment you must install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
@ -25,9 +27,9 @@ $ sudo dnf install gnome-terminal
To install Docker Desktop on Fedora:
1. Set up [Docker's package repository](../../../engine/install/fedora.md#set-up-the-repository).
1. Set up [Docker's package repository](../../engine/install/fedora.md#set-up-the-repository).
2. Download latest RPM package from the [release](../release-notes/index.md) page.
2. Download latest RPM package from the [release](../release-notes.md) page.
3. Install the package with dnf as follows:
@ -80,5 +82,5 @@ Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/conf
## Next steps
- Take a look at the [Get started](../../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../../develop/index.md) to learn how to build new applications using Docker.
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

View File

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 89 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 99 KiB

After

Width:  |  Height:  |  Size: 99 KiB

View File

Before

Width:  |  Height:  |  Size: 478 KiB

After

Width:  |  Height:  |  Size: 478 KiB

View File

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 568 B

View File

@ -2,6 +2,8 @@
description: How to install Docker Desktop on Linux
keywords: linux, desktop, docker desktop, docker desktop for linux, dd4l, install, system requirements
title: Install Docker Desktop on Linux
redirect_from:
- /desktop/linux/install/
---
Welcome to Docker Desktop for Linux. This page contains information about system requirements, download URLs, and instructions on how to install and update Docker Desktop for Linux.
@ -30,7 +32,7 @@ To install Docker Desktop successfully, your Linux host must meet the following
- At least 4 GB of RAM.
Docker Desktop for Linux runs a Virtual Machine (VM). For more information on why, see [Why Docker Desktop for Linux runs a VM](install.md#why-docker-desktop-for-linux-runs-a-vm).
Docker Desktop for Linux runs a Virtual Machine (VM). For more information on why, see [Why Docker Desktop for Linux runs a VM](linux-install.md#why-docker-desktop-for-linux-runs-a-vm).
> **Note:**
>
@ -48,14 +50,14 @@ and architectures:
| Platform | x86_64 / amd64 |
|:------------------------|:-----------------------|
| [Ubuntu](install/ubuntu.md) | [{{ yes }}](install/ubuntu.md) |
| [Debian](install/debian.md) | [{{ yes }}](install/debian.md) |
| [Fedora](install/fedora.md) | [{{ yes }}](install/fedora.md) |
| [Ubuntu](ubuntu.md) | [{{ yes }}](ubuntu.md) |
| [Debian](debian.md) | [{{ yes }}](debian.md) |
| [Fedora](fedora.md) | [{{ yes }}](fedora.md) |
> **Note:**
>
> An experimental package is available for [Arch](install/archlinux.md)-based distributions. Docker has not tested or verified the installation.
> An experimental package is available for [Arch](archlinux.md)-based distributions. Docker has not tested or verified the installation.
Docker supports Docker Desktop on the current LTS release of the aforementioned distributions and the most recent version. As new versions are made available, Docker stops supporting the oldest version and supports the newest version.
@ -116,10 +118,10 @@ Log out and log back in so that your group membership is re-evaluated.
## Generic installation steps
1. Download the correct package for your Linux distribution and install it with the corresponding package manager.
- [Install on Debian](install/debian.md)
- [Install on Fedora](install/fedora.md)
- [Install on Ubuntu](install/ubuntu.md)
- [Install on Arch](install/archlinux.md)
- [Install on Debian](debian.md)
- [Install on Fedora](fedora.md)
- [Install on Ubuntu](ubuntu.md)
- [Install on Arch](archlinux.md)
2. Open your **Applications** menu in Gnome/KDE Desktop and search for **Docker Desktop**.
@ -140,8 +142,8 @@ Log out and log back in so that your group membership is re-evaluated.
Docker Desktop for Linux and Docker Engine can be installed side-by-side on the
same machine. Docker Desktop for Linux stores containers and images in an isolated
storage location [within a VM](#why-docker-desktop-for-linux-runs-a-vm) and offers
controls to restrict [its resources](index.md#resources). Using a dedicated storage
storage location [within a VM](linux-install.md#why-docker-desktop-for-linux-runs-a-vm) and offers
controls to restrict [its resources](../linux/index.md#resources). Using a dedicated storage
location for Docker Desktop prevents it from interfering with a Docker Engine
installation on the same machine.
@ -278,11 +280,11 @@ Docker Desktop for Linux runs a Virtual Machine (VM) for the following reasons:
## Where to go next
- [Getting started](index.md) provides an overview of Docker Desktop on Linux, basic Docker command examples, how to get help or give feedback, and links to other topics about Docker Desktop on Linux.
- [Troubleshooting](troubleshoot.md) describes common problems, workarounds, how
- [Getting started](../linux/index.md) provides an overview of Docker Desktop on Linux, basic Docker command examples, how to get help or give feedback, and links to other topics about Docker Desktop on Linux.
- [Troubleshooting](../linux/troubleshoot.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/index.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Release notes](../release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Get started with Docker](../../get-started/index.md) provides a general Docker tutorial.
* [Back up and restore data](../backup-and-restore.md) provides instructions
on backing up and restoring data related to Docker.

View File

@ -4,6 +4,7 @@ keywords: mac, install, download, run, docker, local
title: Install Docker Desktop on Mac
redirect_from:
- /docker-for-mac/install/
- /desktop/mac/install/
---
> **Update to the Docker Desktop terms**
@ -52,13 +53,13 @@ Your Mac must meet the following requirements to install Docker Desktop successf
### Mac with Apple silicon
- Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install **Rosetta 2**. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See the [Known issues section](apple-silicon.md#known-issues). However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
- Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install **Rosetta 2**. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See the [Known issues section](../mac/apple-silicon.md#known-issues). However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
```console
$ softwareupdate --install-rosetta
```
For more information, see [Docker Desktop for Apple silicon](apple-silicon.md).
For more information, see [Docker Desktop for Apple silicon](../mac/apple-silicon.md).
</div>
</div>
@ -70,7 +71,6 @@ Your Mac must meet the following requirements to install Docker Desktop successf
1. Double-click `Docker.dmg` to open the installer, then drag the Docker icon to
the Applications folder.
![Install Docker app](images/docker-app-drag.png)
2. Double-click `Docker.app` in the Applications folder to start Docker. In the example below, the Applications folder is in "grid" view mode.
@ -132,12 +132,12 @@ To uninstall Docker Desktop from your Mac:
## Where to go next
- [Getting started](index.md) provides an overview of Docker Desktop on Mac, basic Docker command examples, how to get help or give feedback, and links to other topics about Docker Desktop on Mac.
- [Docker Desktop for Apple silicon](apple-silicon.md) for detailed information about Docker Desktop for Apple silicon.
- [Troubleshooting](troubleshoot.md) describes common problems, workarounds, how
- [Getting started](../mac/index.md) provides an overview of Docker Desktop on Mac, basic Docker command examples, how to get help or give feedback, and links to other topics about Docker Desktop on Mac.
- [Docker Desktop for Apple silicon](../mac/apple-silicon.md) for detailed information about Docker Desktop for Apple silicon.
- [Troubleshooting](../mac/troubleshoot.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/index.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Release notes](../release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Get started with Docker](../../get-started/index.md) provides a general Docker tutorial.
* [Back up and restore data](../backup-and-restore.md) provides instructions
on backing up and restoring data related to Docker.

View File

@ -3,6 +3,8 @@ description: Instructions for installing Docker Desktop on Ubuntu
keywords: ubuntu, install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
title: Install Docker Desktop on Ubuntu
toc_max: 4
redirect_from:
- /desktop/linux/install/ubuntu/
---
@ -12,7 +14,7 @@ This page contains information on how to install, launch and upgrade Docker Desk
To install Docker Desktop successfully, you must:
- Meet the [system requirements](../install.md#system-requirements)
- Meet the [system requirements](linux-install.md#system-requirements)
- Have a 64-bit version of either Ubuntu Jammy Jellyfish 22.04 (LTS) or Ubuntu Impish Indri 21.10.
Docker Desktop is supported on `x86_64` (or `amd64`) architecture.
- Uninstall the tech preview or beta version of Docker Desktop for Linux. Run:
@ -44,9 +46,9 @@ $ sudo apt install gnome-terminal
Recommended approach to install Docker Desktop on Ubuntu:
1. Set up [Docker's package repository](../../../engine/install/ubuntu.md#set-up-the-repository).
1. Set up [Docker's package repository](../../engine/install/ubuntu.md#set-up-the-repository).
2. Download latest DEB package from the [release](../release-notes/index.md) page.
2. Download latest DEB package from the [release](../release-notes.md) page.
3. Install the package with apt as follows:
@ -108,5 +110,5 @@ Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/conf
## Next steps
- Take a look at the [Get started](../../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../../develop/index.md) to learn how to build new applications using Docker.
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

View File

@ -10,6 +10,7 @@ redirect_from:
- /engine/installation/windows/docker-ee/
- /install/windows/docker-ee/
- /install/windows/ee-preview/
- /desktop/windows/install/
---
> **Update to the Docker Desktop terms**
@ -51,7 +52,7 @@ WSL 2 on Windows 10 or Windows 11:
- 4GB system RAM
- BIOS-level hardware virtualization support must be enabled in the
BIOS settings. For more information, see
[Virtualization](troubleshoot.md#virtualization-must-be-enabled).
[Virtualization](../windows/troubleshoot.md#virtualization-must-be-enabled).
- Download and install the [Linux kernel update package](https://docs.microsoft.com/windows/wsl/wsl2-kernel){: target="_blank" rel="noopener" class="_"}.
</div>
@ -71,7 +72,7 @@ Hyper-V on Windows 10:
- 4GB system RAM
- BIOS-level hardware virtualization support must be enabled in the
BIOS settings. For more information, see
[Virtualization](troubleshoot.md#virtualization-must-be-enabled).
[Virtualization](../windows/troubleshoot.md#virtualization-must-be-enabled).
</div>
</div>
@ -86,13 +87,13 @@ accounts use the same VM to build and run containers. Note that it is not possib
Nested virtualization scenarios, such as running Docker Desktop on a
VMWare or Parallels instance might work, but there are no guarantees. For
more information, see [Running Docker Desktop in nested virtualization scenarios](troubleshoot.md#running-docker-desktop-in-nested-virtualization-scenarios).
more information, see [Running Docker Desktop in nested virtualization scenarios](../windows/troubleshoot.md#running-docker-desktop-in-nested-virtualization-scenarios).
### About Windows containers
Looking for information on using Windows containers?
* [Switch between Windows and Linux containers](index.md#switch-between-windows-and-linux-containers)
* [Switch between Windows and Linux containers](../windows/index.md#switch-between-windows-and-linux-containers)
describes how you can toggle between Linux and Windows containers in Docker Desktop and points you to the tutorial mentioned above.
* [Getting Started with Windows Containers (Lab)](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md)
provides a tutorial on how to set up and run Windows containers on Windows 10, Windows Server 2016 and Windows Server 2019. It shows you how to use a MusicStore application
@ -210,11 +211,11 @@ To uninstall Docker Desktop from your Windows machine:
## Where to go next
* [Getting started](index.md) introduces Docker Desktop for Windows.
* [Getting started](../windows/index.md) introduces Docker Desktop for Windows.
* [Get started with Docker](/get-started/) is a tutorial that teaches you how to
deploy a multi-service stack.
* [Troubleshooting](troubleshoot.md) describes common problems, workarounds, and
* [Troubleshooting](../windows/troubleshoot.md) describes common problems, workarounds, and
how to get support.
* [FAQs](../faqs/general.md) provide answers to frequently asked questions.
* [Release notes](release-notes/index.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
* [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.

View File

@ -6,9 +6,9 @@ title: Docker Desktop for Linux user manual
Welcome to Docker Desktop! The Docker Desktop for Linux user manual provides information on how to configure and manage your Docker Desktop settings.
Docker Desktop is an easy-to-install application that enables you to build and share containerized applications and microservices.
Docker Desktop is an easy-to-install application that enables you to build and share containerized applications and microservices.
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](install.md).
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](../install/linux-install.md).
## Settings

View File

@ -21,7 +21,7 @@ title: Docker Desktop for Mac user manual
Welcome to Docker Desktop! The Docker Desktop for Mac user manual provides information on how to configure and manage your Docker Desktop settings.
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](install.md).
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](../install/mac-install.md).
## Preferences

View File

@ -14,7 +14,7 @@ While Docker Desktop does not generally require the user running or installing i
The reason for this is that Docker Desktop needs to perform a limited set of privileged operations using the privileged helper process `com.docker.vmnetd`. This approach allows, following the principle of least privilege, `root` access to be used only for the operations for which it is absolutely necessary, while still being able to use Docker Desktop as an unprivileged user.
From version 4.11, it will be possible to avoid running a privileged service in the background by using `com.docker.vmnetd` for setup during installation and disabling it at runtime. In this case the user will not be prompted on the first run. Administrators would be able to do that by using the `-user` flag on the [install command](install.md#install-from-the-command-line) which would:
From version 4.11, it will be possible to avoid running a privileged service in the background by using `com.docker.vmnetd` for setup during installation and disabling it at runtime. In this case the user will not be prompted on the first run. Administrators would be able to do that by using the `-user` flag on the [install command](../install/mac-install.md#install-from-the-command-line) which would:
- Uninstall the previous `com.docker.vmnetd` if present
- Set up symlinks for the user
- Ensure that `localhost` and `kubernetes.docker.internal` are present in `/etc/hosts`

View File

@ -234,7 +234,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.md#system-requirements).
in the Apple documentation, and Docker Desktop [Mac system requirements](../install/mac-install.md#system-requirements).
### Workarounds for common problems

View File

@ -230,7 +230,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](../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](../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

@ -171,7 +171,7 @@ This page contains information about the new features, improvements, known issue
**Compose V2 beta**: Docker Desktop now includes the beta version of Compose V2, which supports the `docker compose` command as part of the Docker CLI. While `docker-compose` is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the `docker-compose` commands and flags. It is expected to be a drop-in replacement for `docker-compose`. There are a few remaining flags that have yet to be implemented, see the [docker-compose compatibility list](../../compose/cli-command-compatibility.md) for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop **Experimental** Settings, or by running the command `docker-compose disable-v2`. Let us know your feedback on the new compose command by creating an issue in the [Compose-CLI](https://github.com/docker/compose-cli/issues) GitHub repository.
**Skip Docker Desktop updates**: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see [Docker Desktop updates](../windows/install.md#updates).
**Skip Docker Desktop updates**: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see [Docker Desktop updates](../install/windows-install.md#updates).
### Deprecation
@ -521,7 +521,7 @@ Docker Desktop can sometimes fail to start after updating to version 3.2.0. If y
### New
- Use of three-digit version number for Docker Desktop releases.
- Starting with Docker Desktop 3.0.0, updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](../mac/install.md#updates).
- Starting with Docker Desktop 3.0.0, updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](../install/mac-install.md#updates).
- First version of `docker compose` (as an alternative to the existing `docker-compose`). Supports some basic commands but not the complete functionality of `docker-compose` yet.
- Supports the following subcommands: `up`, `down`, `logs`, `build`, `pull`, `push`, `ls`, `ps`

View File

@ -173,7 +173,7 @@ This page contains information about the new features, improvements, known issue
**Compose V2 beta**: Docker Desktop now includes the beta version of Compose V2, which supports the `docker compose` command as part of the Docker CLI. While `docker-compose` is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the `docker-compose` commands and flags. It is expected to be a drop-in replacement for `docker-compose`. There are a few remaining flags that have yet to be implemented, see the [docker-compose compatibility list](../../compose/cli-command-compatibility.md) for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop **Experimental** Settings, or by running the command `docker-compose disable-v2`. Let us know your feedback on the new compose command by creating an issue in the [Compose-CLI](https://github.com/docker/compose-cli/issues) GitHub repository.
**Skip Docker Desktop updates**: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see [Docker Desktop updates](../windows/install.md#updates).
**Skip Docker Desktop updates**: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see [Docker Desktop updates](../install/windows-install.md#updates).
### Deprecation
@ -425,7 +425,7 @@ For developers in IT managed environments, who dont have administrative acces
### New
- Use of three-digit version number for Docker Desktop releases.
- Docker Desktop updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](../windows/install.md#updates).
- Docker Desktop updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](../install/windows-install.md#updates).
- First version of `docker compose` (as an alternative to the existing `docker-compose`). Supports some basic commands but not the complete functionality of `docker-compose` yet.
- Supports the following subcommands: `up`, `down`, `logs`, `build`, `pull`, `push`, `ls`, `ps`

View File

@ -11,7 +11,7 @@ redirect_from:
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 information about Stable releases, see the [Stable release notes](../mac/index.md). For Docker Desktop system requirements, see
[What to know before you install](../mac/install.md#system-requirements).
[What to know before you install](../install/mac-install.md#system-requirements).
## Docker Desktop Community 2.5.4
2020-12-07
@ -2163,7 +2163,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](../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](../install/mac-install.md).
**Upgrades**

View File

@ -11,7 +11,7 @@ redirect_from:
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 information about Stable releases, see the [Stable release notes](../windows/release-notes/index.md). For Docker Desktop system requirements, see
[What to know before you install](../windows/install.md#system-requirements).
[What to know before you install](../install/windows-install.md#system-requirements).
## Docker Desktop Community 2.5.4
2020-12-07
@ -2347,7 +2347,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](../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](../install/windows-install.md).
* Removed the docker host name. Containers with exported ports are reachable via localhost.

View File

@ -70,9 +70,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](mac/install.md#system-requirements)
* [Windows system requirements](windows/install.md#system-requirements)
* [Linux system requirements](linux/install.md#system-requirements)
* [Mac system requirements](install/mac-install.md#system-requirements)
* [Windows system requirements](install/windows-install.md#system-requirements)
* [Linux system requirements](install/linux-install.md#system-requirements)
### How is personal diagnostic data handled in Docker Desktop?

View File

@ -18,7 +18,7 @@ title: Docker Desktop for Windows user manual
Welcome to Docker Desktop! The Docker Desktop for Windows user manual provides information on how to configure and manage your Docker Desktop settings.
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](install.md).
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](../install/windows-install.md).
## Settings

View File

@ -49,9 +49,9 @@ organization. To do this:
Download Docker Desktop 4.0 or a later release.
- [Download and install for Windows](/desktop/windows/install/)
- [Download and install for Mac](/desktop/mac/install/)
- [Download and install for Linux](/desktop/linux/install)
- [Download and install for Windows](/desktop/install/windows-install)
- [Download and install for Mac](/desktop/install/mac-install/)
- [Download and install for Linux](/desktop/install/linux-install)
{% include configure-registry-json.md %}

View File

@ -10,8 +10,8 @@ Registry Access Management is a feature available to organizations with a Docker
Download Docker Desktop v4.8 or a later release.
- [Download and install for Windows](/desktop/windows/install/)
- [Download and install for Mac](/desktop/mac/install/)
- [Download and install for Windows](/desktop/install/windows-install/)
- [Download and install for Mac](/desktop/install/mac-install/)
## Configure Registry Access Management permissions

View File

@ -33,13 +33,13 @@ redirect_from:
> Docker Desktop helps you build, share, and run containers easily on Mac and
> Windows as you do on Linux. We are excited to share that Docker Desktop for
> Linux is now GA. For more information, see
[Docker Desktop for Linux](../../desktop/linux/install.md).
[Docker Desktop for Linux](../../desktop/install/linux-install.md).
{: .important}
## Supported platforms
Docker Engine is available on a variety of [Linux platforms](../../desktop/linux/install.md),
[macOS](../../desktop/mac/install.md) and [Windows 10](../../desktop/windows/install.md)
Docker Engine is available on a variety of [Linux platforms](../../desktop/install/linux-install.md),
[macOS](../../desktop/install/mac-install.md) and [Windows 10](../../desktop/install/windows-install.md)
through Docker Desktop, and as a [static binary installation](binaries.md). Find
your preferred operating system below.
@ -49,9 +49,9 @@ your preferred operating system below.
| Platform | x86_64 / amd64 | arm64 (Apple Silicon) |
|:------------------------------------------------------------------|:------------------------------------------------:|:------------------------------------------------:|
| [Docker Desktop for Linux](../../desktop/linux/install.md) | [{{ yes }}](../../desktop/linux/install.md) | |
| [Docker Desktop for Mac (macOS)](../../desktop/mac/install.md) | [{{ yes }}](../../desktop/mac/install.md) | [{{ yes }}](../../desktop/mac/install.md) |
| [Docker Desktop for Windows](../../desktop/windows/install.md) | [{{ yes }}](../../desktop/windows/install.md) | |
| [Docker Desktop for Linux](../../desktop/install/linux-install.md) | [{{ yes }}](../../desktop/install/linux-install.md) | |
| [Docker Desktop for Mac (macOS)](../../desktop/install/mac-install.md) | [{{ yes }}](../../desktop/install/mac-install.md) | [{{ yes }}](../../desktop/install/mac-install.md) |
| [Docker Desktop for Windows](../../desktop/install/windows-install.md) | [{{ yes }}](../../desktop/install/windows-install.md) | |
### Server

View File

@ -21,7 +21,7 @@ toc_max: 4
> Docker Desktop helps you build, share, and run containers easily on Mac and
> Windows as you do on Linux. We are excited to share that Docker Desktop for
> Linux is now GA. For more information, see
[Docker Desktop for Linux](../../desktop/linux/install.md).
[Docker Desktop for Linux](../../desktop/install/linux-install.md).
{: .important}
To get started with Docker Engine on Ubuntu, make sure you

View File

@ -31,27 +31,27 @@ section and choose the best installation path for you.
<div class="col-xs-12 col-sm-12 col-md-12 col-lg-4 block">
<div class="component">
<div class="component-icon">
<a href="/desktop/mac/install/"><img src="/images/apple_48.svg" alt="Docker Desktop for Mac" width="70" height="70"></a>
<a href=""><img src="/images/apple_48.svg" alt="Docker Desktop for Mac" width="70" height="70"></a>
</div>
<h2 id="docker-for-mac"><a href="/desktop/mac/install/">Docker Desktop for Mac</a></h2>
<h2 id="docker-for-mac"><a href="/desktop/install/mac-install/">Docker Desktop for Mac</a></h2>
<p>A native application using the macOS sandbox security model which delivers all Docker tools to your Mac.</p>
</div>
</div>
<div class="col-xs-12 col-sm-12 col-md-12 col-lg-4 block">
<div class="component">
<div class="component-icon">
<a href="/desktop/windows/install/"><img src="/images/windows_48.svg" alt="Docker Desktop for Windows" width="70" height="70"></a>
<a href="/desktop/install/windows-install/"><img src="/images/windows_48.svg" alt="Docker Desktop for Windows" width="70" height="70"></a>
</div>
<h2 id="docker-for-windows/install/"><a href="/desktop/windows/install/">Docker Desktop for Windows</a></h2>
<h2 id="docker-for-windows/install/"><a href="/desktop/install/windows-install/">Docker Desktop for Windows</a></h2>
<p>A native Windows application which delivers all Docker tools to your Windows computer.</p>
</div>
</div>
<div class="col-xs-12 col-sm-12 col-md-12 col-lg-4 block">
<div class="component">
<div class="component-icon">
<a href="/desktop/linux/install/"><img src="/images/linux_48.svg" alt="Docker for Linux" width="70" height="70"></a>
<a href="/desktop/install/linux-install/"><img src="/images/linux_48.svg" alt="Docker for Linux" width="70" height="70"></a>
</div>
<h2 id="docker-for-linux"><a href="/desktop/linux/install/">Docker Desktop for Linux</a></h2>
<h2 id="docker-for-linux"><a href="/desktop/install/linux-install/">Docker Desktop for Linux</a></h2>
<p>A native Linux application which delivers all Docker tools to your Linux computer.</p>
</div>
</div>

View File

@ -89,12 +89,12 @@ machine. If you do not have Docker installed, choose your preferred operating sy
[Mac with Intel chip](https://desktop.docker.com/mac/main/amd64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-amd64){: .button .primary-btn }
[Mac with Apple chip](https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64){: .button .primary-btn }
[Windows](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 .primary-btn }
[Linux](../desktop/linux/install.md){: .button .primary-btn}
[Linux](../desktop/install/linux-install.md){: .button .primary-btn}
For Docker Desktop installation instructions, see:
- [Install Docker Desktop on Mac](../desktop/mac/install.md)
- [Install Docker Desktop on Windows](../desktop/windows/install.md)
- [Install Docker Desktop on Linux](../desktop/linux/install.md)
- [Install Docker Desktop on Mac](../desktop/install/mac-install.md)
- [Install Docker Desktop on Windows](../desktop/install/windows-install.md)
- [Install Docker Desktop on Linux](../desktop/install/linux-install.md)
## Start the tutorial