Engdocs 2177 (#20583)

* ENGDOCS-2177

* ENGDOCS-2177

* remove old images and other minor edits

* edits

Author: aevesdocker

content/desktop/install/archlinux.md

@@ -14,15 +14,11 @@ aliases:
 > employees OR more than $10 million USD in annual revenue) requires a [paid
 > 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.
-
-{{< 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)_
+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.
 
 ## 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:
 
@@ -37,19 +33,29 @@ $ 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.
    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:
 
    ```console
    $ 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
 
 {{< include "desktop-linux-launch.md" >}}
 
 ## 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.
 - [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.

content/desktop/install/debian.md

@@ -16,15 +16,11 @@ aliases:
 
 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
 
 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.
 - For a Gnome Desktop environment, you must also install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
 
@@ -41,14 +37,15 @@ Recommended approach to install Docker Desktop on Debian:
 1. Set up Docker's `apt` 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:
 
   ```console
   $ sudo apt-get update
   $ sudo apt-get install ./docker-desktop-<arch>.deb
   ```
+   Don't forget to substitute `<arch>` with the architecture you want.
 
   > **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)
   > ```
 
+   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.
 
 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
 ```
 
+Don't forget to substitute `<arch>` with the architecture you want.
+
 ## 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.
 - [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.

content/desktop/install/fedora.md

@@ -16,13 +16,11 @@ aliases:
 
 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
 
 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.
 
 Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
@@ -39,14 +37,18 @@ To install Docker Desktop on Fedora:
 
 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:
 
    ```console
    $ 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.
 
 The post-install script:
@@ -70,7 +72,15 @@ $ sudo dnf remove docker-desktop
 $ sudo dnf install ./docker-desktop-<arch>.rpm
 ```
 
+Don't forget to substitute `<arch>` with the architecture you want.
+
 ## 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.
 - [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.

content/desktop/install/images/docker-app-search.png

@@ -25,14 +25,11 @@ 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. 
 >
->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). 
-{ .important } 
-
-{{< accordion title=" 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**
 >
-> For commercial use of Docker Engine obtained via Docker Desktop within larger enterprises (exceeding 250 employees OR with annual revenue surpassing $10 million USD), a [paid subscription](https://www.docker.com/pricing/) is required.
+> For commercial use of Docker Engine obtained via Docker Desktop within larger enterprises (exceeding 250 employees  OR with annual revenue surpassing $10 million USD), a [paid subscription](https://www.docker.com/pricing/) is required.
 { .important }
 
 Docker Desktop for Linux provides a user-friendly graphical interface that simplifies the management of containers and services. It includes Docker Engine as this is the core technology that powers Docker containers. Docker Desktop for Linux also comes with additional features like Docker Scout and Docker Extensions.
@@ -103,18 +100,17 @@ $ docker context use default
 default
 Current context is now "default"
 ```
-
+  
 And use the `desktop-linux` context to interact with Docker Desktop:
-
+ 
 ```console
 $ docker context use desktop-linux
 desktop-linux
 Current context is now "desktop-linux"
-```
-
+``` 
 Refer to the [Docker Context documentation](/engine/manage-resources/contexts.md) for more details.
-
 {{< /accordion >}}
+{ .important }
 
 ## 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.
 
+## Where to go next
 
-## Generic installation steps
-
-> **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 Docker Desktop for Linux for your specific Linux distribution:
    - [Install on Ubuntu](ubuntu.md)
    - [Install on Debian](debian.md)
    - [Install on Red Hat Enterprise Linux (RHEL)](rhel.md)
    - [Install on Fedora](fedora.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.

content/desktop/install/linux-install.md

@@ -53,19 +53,17 @@ This page contains download URLs, information about system requirements, and ins
   { .important }
 
 - At least 4 GB of RAM.
-  
-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:
+- 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:
 
-  ```console
-  $ softwareupdate --install-rosetta
-  ```
+   ```console
+   $ softwareupdate --install-rosetta
+   ```
 {{< /tab >}}
 {{< /tabs >}}
 
 ## Install and run Docker Desktop on Mac
 
-{{< tabs >}}
-{{< tab name="Install interactively" >}}
+### Install interactively
 
 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.
 
-   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: 
    - **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.
-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 >}}
-{{< tab name="Install from the command line" >}}
+### 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:
 
@@ -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-exclude=<hosts/domains>`: Bypasses proxy settings for the hosts and domains. It's a comma-separated list.
 
-{{< /tab >}}
-{{< /tabs >}}
-
 > **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).

content/desktop/install/mac-install.md

@@ -25,7 +25,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](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.
 
 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
    ```
 
+   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.
 
 The post-install script:
@@ -134,5 +136,11 @@ $ sudo dnf install ./docker-desktop-<arch>-rhel.rpm
 
 ## 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.
 - [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.