Merge pull request #1803 from jasonrandrews/review

update Docker install guide

Author: jasonrandrews

content/install-guides/_images/docker-desktop.png

@@ -23,10 +23,10 @@ The operating system of the computer and the architecture (x86 or Arm) determine
 
 ### How do I install Docker on Linux and Chrome OS?
 
-- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (AArch64). Use these instructions for Linux and Chrome OS (using the Linux feature). This includes the Windows Subsystem for Linux 2 (WSL 2).
+- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (AArch64). Use the Docker Engine instructions for Linux and Chrome OS (using the Linux feature). This includes the Windows Subsystem for Linux 2 (WSL 2).
 
 ### How do I install Docker on Windows and macOS?
 
 - Docker Desktop is the easiest way to install Docker on Windows and macOS. The macOS version supports both Intel and Apple Silicon. 
-- The Windows on Arm version of Docker Desktop was announced at Microsoft Build 2024. 
-- Docker Desktop for Linux is available if your machine has KVM support and is running a KDE or Gnome desktop environment.    
+- The Windows on Arm version of Docker Desktop was announced at Microsoft Build 2024 and is available as a Beta release.
+- Docker Desktop for Arm Linux is available if your machine has KVM support and is running a KDE or Gnome desktop environment. Refer to Docker Desktop for Arm Linux below for details.

content/install-guides/_images/docker-icon.png

@@ -0,0 +1,104 @@
+---
+### Title the install tools article with the name of the tool to be installed
+### Include vendor name where appropriate
+title: Docker Desktop for Arm Linux
+
+### Optional additional search terms (one per line) to assist in finding the article
+additional_search_terms:
+- containers
+- virtual machines
+
+### Estimated completion time in minutes (please use integer multiple of 5)
+minutes_to_complete: 15
+
+author: Jason Andrews
+
+### Link to official documentation
+official_docs: https://docs.docker.com/desktop/
+
+weight: 4                       # Defines page ordering. Must be 1 for first (or only) page.
+tool_install: false             # Set to true to be listed in main selection page, else false
+multi_install: false            # Set to true if first page of multi-page article, else false
+multitool_install_part: true    # Set to true if a sub-page of a multi-page article, else false
+layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
+---
+
+## How do I install Docker Desktop for Arm Linux?
+
+Docker Desktop is available for Arm Linux, but not yet documented.
+
+Make sure you are on an Arm Linux computer by running:
+
+```console
+uname -m
+```
+
+The output should be:
+
+```output
+aarch64
+```
+
+Before installing Docker Desktop install Docker Engine using:
+
+```console
+curl -fsSL get.docker.com -o get-docker.sh && sh get-docker.sh
+sudo usermod -aG docker $USER ; newgrp docker
+```
+
+You can download and install Docker Desktop on Ubuntu and Debian distributions. 
+
+The path to the download depends on the version. The easiest way is to copy the link for the Debian download of Docker Desktop from the latest [Docker Desktop release notes](https://docs.docker.com/desktop/release-notes/) and replace the instances of `amd64` with `arm64`. This will provide the URL to download.
+
+For example:
+
+```console
+wget https://desktop.docker.com/linux/main/arm64/187762/docker-desktop-arm64.deb
+```
+
+Install Docker Desktop using:
+
+```console
+sudo apt install ./docker-desktop-arm64.deb
+```
+
+The Docker icon is now available to start Docker Desktop.
+
+![img1 #center](/install-guides/_images/docker-icon.png)
+
+To print the Docker Desktop version use:
+
+```console
+docker version
+```
+
+The output may be different depending on your version:
+
+```output
+Server: Docker Desktop 4.40.0 (187762)
+ Engine:
+  Version:          28.0.4
+  API version:      1.48 (minimum version 1.24)
+  Go version:       go1.23.7
+  Git commit:       6430e49
+  Built:            Tue Mar 25 15:07:18 2025
+  OS/Arch:          linux/arm64
+  Experimental:     false
+ containerd:
+  Version:          1.7.26
+  GitCommit:        753481ec61c7c8955a23d6ff7bc8e4daed455734
+ runc:
+  Version:          1.2.5
+  GitCommit:        v1.2.5-0-g59923ef
+ docker-init:
+  Version:          0.19.0
+  GitCommit:        de40ad0
+```
+
+You can now use Docker Desktop on Arm Linux. The image below shows Docker Desktop running on a System76 Thelio Astra with Ubuntu 24.04 desktop.
+
+![img1 #center](/install-guides/_images/docker-desktop.png)
+
+Docker Desktop is now ready to use. You can explore [Docker related Learning Paths](/tag/docker/).
+
+You may want to create an account on [Docker Hub](https://hub.docker.com) to share images and automate workflows.

content/install-guides/docker/_index.md

@@ -34,7 +34,14 @@ All of the download files are available on the
 | [Linux](https://docs.docker.com/desktop/install/linux-install/) |
 | [macOS](https://docs.docker.com/desktop/install/mac-install) |
 
-All of the Docker Desktop products use the `x86_64` / `amd64` architecture except macOS on Apple Silicon.
+
+{{% notice Note %}}
+Docker Desktop for Windows on Arm is available as a Beta release. It is fully documented and works the same as the x86 platform.
+
+For information about Docker Desktop on Arm Linux refer to [Docker Desktop on Arm Linux](/install-guides/docker/docker-desktop-arm-linux/).
+{{% /notice %}}
+
+
 
 On any platform, confirm the Docker Desktop installation is successful with:
 ```console
@@ -71,6 +78,6 @@ uname -m
 
 Apple Silicon is reported as `arm64`.
 
-Docker Engine is now ready to use. You can explore [Docker related Learning Paths](/tag/docker/).
+Docker Desktop is now ready to use. You can explore [Docker related Learning Paths](/tag/docker/).
 
 You may want to create an account on [Docker Hub](https://hub.docker.com) to share images and automate workflows.