diff --git a/content/install-guides/_images/docker-desktop.png b/content/install-guides/_images/docker-desktop.png new file mode 100644 index 0000000000..e850e3f5ea Binary files /dev/null and b/content/install-guides/_images/docker-desktop.png differ diff --git a/content/install-guides/_images/docker-icon.png b/content/install-guides/_images/docker-icon.png new file mode 100644 index 0000000000..7b76597e4a Binary files /dev/null and b/content/install-guides/_images/docker-icon.png differ diff --git a/content/install-guides/docker/_index.md b/content/install-guides/docker/_index.md index 97b2f30a5f..133cb6ef6e 100644 --- a/content/install-guides/docker/_index.md +++ b/content/install-guides/docker/_index.md @@ -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. diff --git a/content/install-guides/docker/docker-desktop-arm-linux.md b/content/install-guides/docker/docker-desktop-arm-linux.md new file mode 100644 index 0000000000..4486456ec3 --- /dev/null +++ b/content/install-guides/docker/docker-desktop-arm-linux.md @@ -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. diff --git a/content/install-guides/docker/docker-desktop.md b/content/install-guides/docker/docker-desktop.md index cbbcc7d1d5..dfcb0aabb3 100644 --- a/content/install-guides/docker/docker-desktop.md +++ b/content/install-guides/docker/docker-desktop.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. diff --git a/content/install-guides/docker/docker-woa.md b/content/install-guides/docker/docker-woa.md deleted file mode 100644 index c5acee60d1..0000000000 --- a/content/install-guides/docker/docker-woa.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -### Title the install tools article with the name of the tool to be installed -### Include vendor name where appropriate -title: Docker for Windows on Arm - -### 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 for Windows on Arm? - -Docker Desktop on Windows requires WSL 2 or Hyper-V. Both are available for Windows on Arm. - -Docker Desktop for Windows on Arm was [announced at Microsoft Build 2024](https://www.docker.com/blog/announcing-docker-desktop-support-for-windows-on-arm/). The first available version is 4.30. - -### What should I do before installing Docker Desktop for Windows on Arm? - -- Install WSL 2 on the Windows on Arm laptop, or turn on Hyper-V and Containers Windows features. - -### Which Windows on Arm computers are supported? - -Here are three examples of Windows on Arm computers: -- Lenovo Thinkpad X13s. -- Microsoft Surface Pro X. -- Samsung Galaxy Book S. - -Additional models of Windows on Arm computers are expected to be available in mid-2024. - -### How do I install and test Docker Desktop for Windows on Arm? - -The current version is 4.33.1 and you can -download [Docker Desktop for Windows on Arm](https://desktop.docker.com/win/main/arm64/161083/Docker%20Desktop%20Installer.exe) and run the installer. - -Check the [Docker Desktop release notes](https://docs.docker.com/desktop/release-notes/) for the latest release information. - -Once the installation is complete, you can test it by running `docker` in a Windows Command Prompt or PowerShell Prompt: - -```console -docker run hello-world -``` - -You should see a welcome message similar to the following: - -```output -Hello from Docker! -This message shows that your installation appears to be working correctly. - -To generate this message, Docker took the following steps: - 1. The Docker client contacted the Docker daemon. - 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. - (arm64v8) - 3. The Docker daemon created a new container from that image which runs the - executable that produces the output you are currently reading. - 4. The Docker daemon streamed that output to the Docker client, which sent it - to your terminal. - -To try something more ambitious, you can run an Ubuntu container with: - $ docker run -it ubuntu bash - -Share images, automate workflows, and more with a free Docker ID: - https://hub.docker.com/ - -For more examples and ideas, visit: - https://docs.docker.com/get-started/ - -``` - -Docker Desktop is now ready to use for Windows on Arm. - -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.