Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/install-guides/_images/docker-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions content/install-guides/docker/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
104 changes: 104 additions & 0 deletions content/install-guides/docker/docker-desktop-arm-linux.md
Original file line number Diff line number Diff line change
@@ -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.
11 changes: 9 additions & 2 deletions content/install-guides/docker/docker-desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
88 changes: 0 additions & 88 deletions content/install-guides/docker/docker-woa.md

This file was deleted.