docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Engdocs 2177 (#20583) 

* ENGDOCS-2177

* ENGDOCS-2177

* remove old images and other minor edits

* edits
This commit is contained in:
Allie Sadler 2024-08-14 13:21:01 +01:00 committed by GitHub
parent ebfe67a54a
commit 99db35c5ad
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
10 changed files with 119 additions and 114 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
content/desktop/install/archlinux.md
View File

@ -14,15 +14,11 @@ aliases:
> employees OR more than $10 million USD in annual revenue) requires a [paid > employees OR more than $10 million USD in annual revenue) requires a [paid
> subscription](https://www.docker.com/pricing/). > subscription](https://www.docker.com/pricing/).
This topic discusses installation of Docker Desktop from an [Arch package](https://desktop.docker.com/linux/main/amd64/docker-desktop-x86_64.pkg.tar.zst) that Docker provides in addition to the supported platforms. Docker has not tested or verified the installation. This page contains information on how to install, launch and upgrade Docker Desktop on an Arch-based distribution. Docker has not tested or verified the installation.
{{< button text="Arch package (experimental)" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-x86_64.pkg.tar.zst?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
_For checksums, see [Release notes](../release-notes.md)_
## Prerequisites ## Prerequisites
To install Docker Desktop successfully, you must meet the [system requirements](linux-install.md#system-requirements). To install Docker Desktop successfully, you must meet the [general system requirements](linux-install.md#general-system-requirements).
Additionally, for non-Gnome Desktop environments, `gnome-terminal` must be installed: Additionally, for non-Gnome Desktop environments, `gnome-terminal` must be installed:
@ -37,7 +33,7 @@ $ sudo pacman -S gnome-terminal
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`). Static binaries for the Docker client are available for Linux (as `docker`).
3. Download the Arch package from the [release](../release-notes.md) page. 3. Download the latest Arch package from the [Release notes](../release-notes.md).
4. Install the package: 4. Install the package:
@ -45,11 +41,21 @@ $ sudo pacman -S gnome-terminal
$ sudo pacman -U ./docker-desktop-<arch>.pkg.tar.zst $ sudo pacman -U ./docker-desktop-<arch>.pkg.tar.zst
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
By default, Docker Desktop is installed at `/opt/docker-desktop`.
## Launch Docker Desktop ## Launch Docker Desktop
{{< include "desktop-linux-launch.md" >}} {{< include "desktop-linux-launch.md" >}}
## Next steps ## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application. - Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features. - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

19
content/desktop/install/debian.md
View File

@ -16,15 +16,11 @@ aliases:
This page contains information on how to install, launch, and upgrade Docker Desktop on a Debian distribution. This page contains information on how to install, launch, and upgrade Docker Desktop on a Debian distribution.
{{< button text="DEB package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
_For checksums, see [Release notes](../release-notes.md)_
## Prerequisites ## Prerequisites
To install Docker Desktop successfully, you must: To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#system-requirements). - Meet the [general system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of Debian 12. - Have a 64-bit version of Debian 12.
- For a Gnome Desktop environment, you must also install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/). - For a Gnome Desktop environment, you must also install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
@ -41,7 +37,7 @@ Recommended approach to install Docker Desktop on Debian:
1. Set up Docker's `apt` repository. 1. Set up Docker's `apt` repository.
See step one of [Install using the `apt` repository](../../engine/install/debian.md#install-using-the-repository). See step one of [Install using the `apt` repository](../../engine/install/debian.md#install-using-the-repository).
2. Download latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). 2. Download the latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). For checksums, see the [Release notes](../release-notes.md).
3. Install the package with apt as follows: 3. Install the package with apt as follows:
@ -49,6 +45,7 @@ Recommended approach to install Docker Desktop on Debian:
$ sudo apt-get update $ sudo apt-get update
$ sudo apt-get install ./docker-desktop-<arch>.deb $ sudo apt-get install ./docker-desktop-<arch>.deb
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
> **Note** > **Note**
> >
@ -59,6 +56,8 @@ Recommended approach to install Docker Desktop on Debian:
> N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied) > N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
> ``` > ```
By default, Docker Desktop is installed at `/opt/docker-desktop`.
There are a few post-install configuration steps done through the post-install script contained in the deb package. There are a few post-install configuration steps done through the post-install script contained in the deb package.
The post-install script: The post-install script:
@ -81,7 +80,15 @@ You need to download the new package each time you want to upgrade Docker Deskto
$ sudo apt-get install ./docker-desktop-<arch>.deb $ sudo apt-get install ./docker-desktop-<arch>.deb
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
## Next steps ## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application. - Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features. - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

18
content/desktop/install/fedora.md
View File

@ -16,13 +16,11 @@ aliases:
This page contains information on how to install, launch and upgrade Docker Desktop on a Fedora distribution. This page contains information on how to install, launch and upgrade Docker Desktop on a Fedora distribution.
{{< button text="RPM package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-x86_64.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
## Prerequisites ## Prerequisites
To install Docker Desktop successfully, you must: To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#general-system-requirements). - Meet the [general system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of Fedora 39 or Fedora 40. - Have a 64-bit version of Fedora 39 or Fedora 40.
Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/). Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
@ -39,7 +37,7 @@ 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](https://desktop.docker.com/linux/main/amd64/docker-desktop-x86_64.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). 2. Download the latest [RPM package](https://desktop.docker.com/linux/main/amd64/docker-desktop-x86_64.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). For checksums, see the [Release notes](../release-notes.md).
3. Install the package with dnf as follows: 3. Install the package with dnf as follows:
@ -47,6 +45,10 @@ To install Docker Desktop on Fedora:
$ sudo dnf install ./docker-desktop-<arch>.rpm $ sudo dnf install ./docker-desktop-<arch>.rpm
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
By default, Docker Desktop is installed at `/opt/docker-desktop`.
There are a few post-install configuration steps done through the post-install script contained in the RPM package. There are a few post-install configuration steps done through the post-install script contained in the RPM package.
The post-install script: The post-install script:
@ -70,7 +72,15 @@ $ sudo dnf remove docker-desktop
$ sudo dnf install ./docker-desktop-<arch>.rpm $ sudo dnf install ./docker-desktop-<arch>.rpm
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
## Next steps ## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application. - Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features. - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

BIN
content/desktop/install/images/docker-app-search.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 12 KiB

41
content/desktop/install/linux-install.md
View File

@ -25,10 +25,7 @@ This page contains information about general system requirements, supported plat
> >
>This means images and containers deployed on the Linux Docker Engine (before installation) are not available in Docker Desktop for Linux. >This means images and containers deployed on the Linux Docker Engine (before installation) are not available in Docker Desktop for Linux.
> >
>For more information see [What is the difference between Docker Desktop for Linux and Docker Engine](../faqs/linuxfaqs.md#what-is-the-difference-between-docker-desktop-for-linux-and-docker-engine). > {{< accordion title=" What is the difference between Docker Desktop for Linux and Docker Engine?" >}}
{ .important }
{{< accordion title=" What is the difference between Docker Desktop for Linux and Docker Engine?" >}}
> **Important** > **Important**
> >
@ -111,10 +108,9 @@ $ docker context use desktop-linux
desktop-linux desktop-linux
Current context is now "desktop-linux" Current context is now "desktop-linux"
``` ```
Refer to the [Docker Context documentation](/engine/manage-resources/contexts.md) for more details. Refer to the [Docker Context documentation](/engine/manage-resources/contexts.md) for more details.
{{< /accordion >}} {{< /accordion >}}
{ .important }
## Supported platforms ## Supported platforms
@ -208,42 +204,13 @@ $ sudo usermod -aG kvm $USER
Sign out and sign back in so that your group membership is re-evaluated. Sign out and sign back in so that your group membership is re-evaluated.
## Where to go next
## Generic installation steps - Install Docker Desktop for Linux for your specific Linux distribution:
> **Important**
>
> Make sure you meet the system requirements outlined earlier and follow the distro-specific prerequisites.
{ .important }
1. Download the correct package for your Linux distribution and install it with the corresponding package manager.
- [Install on Ubuntu](ubuntu.md) - [Install on Ubuntu](ubuntu.md)
- [Install on Debian](debian.md) - [Install on Debian](debian.md)
- [Install on Red Hat Enterprise Linux (RHEL)](rhel.md) - [Install on Red Hat Enterprise Linux (RHEL)](rhel.md)
- [Install on Fedora](fedora.md) - [Install on Fedora](fedora.md)
- [Install on Arch](archlinux.md) - [Install on Arch](archlinux.md)
By default, Docker Desktop is installed at `/opt/docker-desktop`.
2. Open your **Applications** menu in Gnome/KDE Desktop and search for **Docker Desktop**.
![Docker app in Applications](images/docker-app-in-apps.png)
3. Select **Docker Desktop** to start Docker. <br> The Docker menu ({{< inline-image src="images/whale-x.svg" alt="whale menu" >}}) displays the Docker Subscription Service Agreement.
4. Select **Accept** to continue. Docker Desktop starts after you accept the terms.
Note that Docker Desktop will not run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). We recommend that you also read the [FAQs](https://www.docker.com/pricing/faq).
## Where to go next
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- [Get started with Docker](../../guides/getting-started/_index.md).
- [Explore Docker Desktop](../use-desktop/_index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

17
content/desktop/install/mac-install.md
View File

@ -53,8 +53,7 @@ This page contains download URLs, information about system requirements, and ins
{ .important } { .important }
- At least 4 GB of RAM. - 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:
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 [Known issues](../troubleshoot/known-issues.md). However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
```console ```console
$ softwareupdate --install-rosetta $ softwareupdate --install-rosetta
@ -64,8 +63,7 @@ Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to ins
## Install and run Docker Desktop on Mac ## Install and run Docker Desktop on Mac
{{< tabs >}} ### Install interactively
{{< tab name="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](../release-notes.md).
@ -85,14 +83,14 @@ Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to ins
Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop. Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). We recommend that you also read the [FAQs](https://www.docker.com/pricing/faq). For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). It is recommended that you also read the [FAQs](https://www.docker.com/pricing/faq).
6. From the installation window, select either: 6. From the installation window, select either:
- **Use recommended settings (Requires password)**. This lets Docker Desktop automatically set the necessary configuration settings. - **Use recommended settings (Requires password)**. This lets Docker Desktop automatically set the necessary configuration settings.
- **Use advanced settings**. You can then set the location of the Docker CLI tools either in the system or user directory, enable the default Docker socket, and enable privileged port mapping. See [Settings](../settings/mac.md#advanced), for more information and how to set the location of the Docker CLI tools. - **Use advanced settings**. You can then set the location of the Docker CLI tools either in the system or user directory, enable the default Docker socket, and enable privileged port mapping. See [Settings](../settings/mac.md#advanced), for more information and how to set the location of the Docker CLI tools.
7. Select **Finish**. If you have applied any of the above configurations that require a password in step 6, enter your password to confirm your choice. 7. Select **Finish**. If you have applied any of the previous configurations that require a password in step 6, enter your password to confirm your choice.
{{< /tab >}} ### Install from the command line
{{< tab name="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](../release-notes.md), run the following commands in a terminal to install Docker Desktop in the **Applications** folder:
@ -117,9 +115,6 @@ The `install` command accepts the following flags:
- `--override-proxy-https=<URL>`: Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests, requires `--proxy-http-mode` to be `manual` - `--override-proxy-https=<URL>`: Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests, requires `--proxy-http-mode` to be `manual`
- `--override-proxy-exclude=<hosts/domains>`: Bypasses proxy settings for the hosts and domains. It's a comma-separated list. - `--override-proxy-exclude=<hosts/domains>`: Bypasses proxy settings for the hosts and domains. It's a comma-separated list.
{{< /tab >}}
{{< /tabs >}}
> **Tip** > **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/configure-sign-in.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](../../security/for-admins/configure-sign-in.md).

10
content/desktop/install/rhel.md
View File

@ -25,7 +25,7 @@ This page contains information on how to install, launch and upgrade Docker Desk
To install Docker Desktop successfully, you must: To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#general-system-requirements). - Meet the [general system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of either RHEL 8 or RHEL 9. - Have a 64-bit version of either RHEL 8 or RHEL 9.
If you don't have `pass` installed, or it can't be installed, you must enable If you don't have `pass` installed, or it can't be installed, you must enable
@ -98,6 +98,8 @@ To install Docker Desktop on RHEL:
$ sudo dnf install ./docker-desktop-<arch>-rhel.rpm $ sudo dnf install ./docker-desktop-<arch>-rhel.rpm
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
There are a few post-install configuration steps done through the post-install script contained in the RPM package. There are a few post-install configuration steps done through the post-install script contained in the RPM package.
The post-install script: The post-install script:
@ -134,5 +136,11 @@ $ sudo dnf install ./docker-desktop-<arch>-rhel.rpm
## Next steps ## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application. - Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features. - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

20
content/desktop/install/ubuntu.md
View File

@ -19,15 +19,11 @@ aliases:
This page contains information on how to install, launch and upgrade Docker Desktop on an Ubuntu distribution. This page contains information on how to install, launch and upgrade Docker Desktop on an Ubuntu distribution.
{{< button text="DEB package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
_For checksums, see [Release notes](../release-notes.md)_
## Prerequisites ## Prerequisites
To install Docker Desktop successfully, you must: To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#system-requirements) - Meet the [general system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of either the LTS version Ubuntu Jammy Jellyfish 22.04, or the current non-LTS version. Docker Desktop is supported on `x86_64` (or `amd64`) architecture. - Have a 64-bit version of either the LTS version Ubuntu Jammy Jellyfish 22.04, or the current non-LTS version. Docker Desktop is supported on `x86_64` (or `amd64`) architecture.
> **Note** > **Note**
> >
@ -45,7 +41,7 @@ Recommended approach to install Docker Desktop on Ubuntu:
1. Set up Docker's package repository. 1. Set up Docker's package repository.
See step one of [Install using the `apt` repository](../../engine/install/ubuntu.md#install-using-the-repository). See step one of [Install using the `apt` repository](../../engine/install/ubuntu.md#install-using-the-repository).
2. Download latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). 2. Download the latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64). For checksums, see the [Release notes](../release-notes.md).
3. Install the package with apt as follows: 3. Install the package with apt as follows:
@ -54,6 +50,8 @@ Recommended approach to install Docker Desktop on Ubuntu:
$ sudo apt-get install ./docker-desktop-<arch>.deb $ sudo apt-get install ./docker-desktop-<arch>.deb
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
> **Note** > **Note**
> >
> At the end of the installation process, `apt` displays an error due to installing a downloaded package. You > At the end of the installation process, `apt` displays an error due to installing a downloaded package. You
@ -63,6 +61,8 @@ Recommended approach to install Docker Desktop on Ubuntu:
> N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied) > N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
> ``` > ```
By default, Docker Desktop is installed at `/opt/docker-desktop`.
There are a few post-install configuration steps done through the post-install script contained in the deb package. There are a few post-install configuration steps done through the post-install script contained in the deb package.
The post-install script: The post-install script:
@ -85,7 +85,15 @@ You need to download the new package each time you want to upgrade Docker Deskto
$ sudo apt-get install ./docker-desktop-<arch>.deb $ sudo apt-get install ./docker-desktop-<arch>.deb
``` ```
Don't forget to substitute `<arch>` with the architecture you want.
## Next steps ## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application. - Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features. - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
- [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.

52
content/desktop/install/windows-install.md
View File

@ -34,6 +34,11 @@ _For checksums, see [Release notes](../release-notes.md)_
## System requirements ## System requirements
> **Should I use Hyper-V or WSL?**
>
> Docker Desktop's functionality remains consistent on both WSL and Hyper-V, without a preference for either architecture. Hyper-V and WSL have their own advantages and disadvantages, depending on your specific set up and your planned use case.
{ .tip }
{{< tabs >}} {{< tabs >}}
{{< tab name="WSL 2 backend, x86_64" >}} {{< tab name="WSL 2 backend, x86_64" >}}
@ -53,22 +58,22 @@ _For checksums, see [Release notes](../release-notes.md)_
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](../wsl/_index.md).
> **Note**
>
> Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet). Docker Desktop is not supported on server versions of Windows, such as Windows Server 2019 or Windows Server 2022. For more information on how to run containers on Windows Server, see [Microsoft's official documentation](https://learn.microsoft.com/virtualization/windowscontainers/quick-start/set-up-environment).
> **Important** > **Important**
> >
> To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition. > To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition.
> Windows Home or Education editions only allow you to run Linux containers. > Windows Home or Education editions only allow you to run Linux containers.
{ .important } { .important }
> **Note**
>
> Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet). Docker Desktop is not supported on server versions of Windows, such as Windows Server 2019 or Windows Server 2022. For more information on how to run containers on Windows Server, see [Microsoft's official documentation](https://learn.microsoft.com/virtualization/windowscontainers/quick-start/set-up-environment).
{{< /tab >}} {{< /tab >}}
{{< tab name="Hyper-V backend, x86_64" >}} {{< tab name="Hyper-V backend, x86_64" >}}
- Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher. - Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.
- Windows 10 64-bit: - Windows 10 64-bit:
- We recommend Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher. - Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher is recommended.
- Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher. - Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher.
- Turn on Hyper-V and Containers Windows features. - Turn on Hyper-V and Containers Windows features.
- The following hardware prerequisites are required to successfully run Client - The following hardware prerequisites are required to successfully run Client
@ -80,23 +85,23 @@ For more information on setting up WSL 2 with Docker Desktop, see [WSL](../wsl/_
BIOS settings. For more information, see BIOS settings. For more information, see
[Virtualization](../troubleshoot/topics.md#virtualization). [Virtualization](../troubleshoot/topics.md#virtualization).
> **Important**
>
> To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition.
> Windows Home or Education editions only allow you to run Linux containers.
{ .important }
> **Note** > **Note**
> >
> Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet). Docker Desktop is not supported on server versions of Windows, such as Windows Server 2019 or Windows Server 2022. For more information on how to run containers on Windows Server, see [Microsoft's official documentation](https://learn.microsoft.com/virtualization/windowscontainers/quick-start/set-up-environment). > Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet). Docker Desktop is not supported on server versions of Windows, such as Windows Server 2019 or Windows Server 2022. For more information on how to run containers on Windows Server, see [Microsoft's official documentation](https://learn.microsoft.com/virtualization/windowscontainers/quick-start/set-up-environment).
> **Important**
>
> To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition.
> Windows Home or Education editions only let you run Linux containers.
{ .important }
{{< /tab >}} {{< /tab >}}
{{< tab name="WSL 2 backend, Arm (Beta)" >}} {{< tab name="WSL 2 backend, Arm (Beta)" >}}
- WSL version 1.1.3.0 or later. - WSL version 1.1.3.0 or later.
- Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher. - Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.
- Windows 10 64-bit: - Windows 10 64-bit:
- We recommend Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher. - Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher is recommended.
- Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher. - Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher.
- Turn on the WSL 2 feature on Windows. For detailed instructions, refer to the - Turn on the WSL 2 feature on Windows. For detailed instructions, refer to the
[Microsoft documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10). [Microsoft documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
@ -117,11 +122,6 @@ For more information on setting up WSL 2 with Docker Desktop, see [WSL](../wsl/_
{{< /tab >}} {{< /tab >}}
{{< /tabs >}} {{< /tabs >}}
> **Should I use Hyper-V or WSL?**
>
> Docker Desktop's functionality remains consistent on both WSL and Hyper-V, without a preference for either architecture. Hyper-V and WSL have their own advantages and disadvantages, depending on your specific set up and your planned use case.
{ .tip }
Containers and images created with Docker Desktop are shared between all Containers and images created with Docker Desktop are shared between all
user accounts on machines where it is installed. This is because all Windows user accounts on machines where it is installed. This is because all Windows
accounts use the same VM to build and run containers. Note that it is not possible to share containers and images between user accounts when using the Docker Desktop WSL 2 backend. accounts use the same VM to build and run containers. Note that it is not possible to share containers and images between user accounts when using the Docker Desktop WSL 2 backend.
@ -166,8 +166,7 @@ again when you switch back.
## Install Docker Desktop on Windows ## Install Docker Desktop on Windows
{{< tabs >}} ### Install interactively
{{< tab name="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](../release-notes.md).
@ -175,20 +174,21 @@ again when you switch back.
3. When prompted, ensure the **Use WSL 2 instead of Hyper-V** option on the Configuration page is selected or not depending on your choice of backend. 3. When prompted, ensure the **Use WSL 2 instead of Hyper-V** option on the Configuration page is selected or not depending on your choice of backend.
If your system only supports one of the two options, you will not be able to select which backend to use. If your system only supports one of the two options, you won't be able to select which backend to use.
4. Follow the instructions on the installation wizard to authorize the installer and proceed with the install. 4. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
5. When the installation is successful, select **Close** to complete the installation process. 5. When the installation is successful, select **Close** to complete the installation process.
If your admin account is different to your user account, you must add the user to the **docker-users** group: 6. [Start Docker Desktop](#start-docker-desktop).
If your administrator account is different to your user account, you must add the user to the **docker-users** group:
1. Run **Computer Management** as an **administrator**. 1. Run **Computer Management** as an **administrator**.
2. Navigate to **Local Users and Groups** > **Groups** > **docker-users**. 2. Navigate to **Local Users and Groups** > **Groups** > **docker-users**.
3. Right-click to add the user to the group. 3. Right-click to add the user to the group.
4. Sign out and sign back in for the changes to take effect. 4. Sign out and sign back in for the changes to take effect.
{{< /tab >}} ### Install from the command line
{{< tab name="Install from the command line" >}}
After downloading `Docker Desktop Installer.exe`, run the following command in a terminal to install Docker Desktop: After downloading `Docker Desktop Installer.exe`, run the following command in a terminal to install Docker Desktop:
@ -248,8 +248,6 @@ If your admin account is different to your user account, you must add the user t
```console ```console
$ net localgroup docker-users <user> /add $ net localgroup docker-users <user> /add
``` ```
{{< /tab >}}
{{< /tabs >}}
## Start Docker Desktop ## Start Docker Desktop
@ -257,8 +255,6 @@ Docker Desktop does not start automatically after installation. To start Docker
1. Search for Docker, and select **Docker Desktop** in the search results. 1. Search for Docker, and select **Docker Desktop** in the search results.
![Search for Docker app](images/docker-app-search.png)
2. The Docker menu ({{< inline-image src="images/whale-x.svg" alt="whale menu" >}}) displays the Docker Subscription Service Agreement. 2. The Docker menu ({{< inline-image src="images/whale-x.svg" alt="whale menu" >}}) displays the Docker Subscription Service Agreement.
{{< include "desktop-license-update.md" >}} {{< include "desktop-license-update.md" >}}
@ -267,7 +263,7 @@ Docker Desktop does not start automatically after installation. To start Docker
Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop. Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement/). We recommend that you also read the [FAQs](https://www.docker.com/pricing/faq). For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement/). It is recommended that you read the [FAQs](https://www.docker.com/pricing/faq).
> **Tip** > **Tip**
> >

22
content/includes/desktop-linux-launch.md
View File

@ -1,6 +1,14 @@
To start Docker Desktop for Linux, search **Docker Desktop** on the To start Docker Desktop for Linux:
**Applications** menu and open it. This launches the Docker menu icon and opens
the Docker Dashboard, reporting the status of Docker Desktop. 1. Open your **Applications** menu in Gnome/KDE Desktop and search for **Docker Desktop**.
2. Select **Docker Desktop** to start Docker. <br> The Docker menu ({{< inline-image src="images/whale-x.svg" alt="whale menu" >}}) displays the Docker Subscription Service Agreement.
3. Select **Accept** to continue. Docker Desktop starts after you accept the terms.
Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). It is recommended that you also read the [FAQs](https://www.docker.com/pricing/faq).
Alternatively, open a terminal and run: Alternatively, open a terminal and run:
@ -25,16 +33,16 @@ of these binaries by running the following commands:
```console ```console
$ docker compose version $ docker compose version
Docker Compose version v2.17.3 Docker Compose version v2.29.1
$ docker --version $ docker --version
Docker version 23.0.5, build bc4487a Docker version 27.1.1, build 6312585
$ docker version $ docker version
Client: Docker Engine - Community Client:
Cloud integration: v1.0.31
Version: 23.0.5 Version: 23.0.5
API version: 1.42 API version: 1.42
Go version: go1.21.12
<...> <...>
``` ```