From 772692f0f30078202eceb7582037bc84fb661467 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Gronowski?= <pawel.gronowski@docker.com>
Date: Fri, 3 Oct 2025 10:12:59 +0000
Subject: [PATCH] engine/install: deprecate Raspberry Pi OS 32-bit (armhf)
 support (#23489)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Starting with Docker Engine v29, 32-bit Raspberry Pi OS (armhf) packages
will no longer be provided for new major versions.

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
---
 _vale/config/vocabularies/Docker/accept.txt   |  1 +
 .../manuals/engine/install/raspberry-pi-os.md | 25 ++++++++++++++++---
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt
index c9b08c8ea7..a34666b13c 100644
--- a/_vale/config/vocabularies/Docker/accept.txt
+++ b/_vale/config/vocabularies/Docker/accept.txt
@@ -6,6 +6,7 @@ Amazon
 Anchore
 Apple
 Artifactory
+armhf
 auditable
 autolock
 Azure
diff --git a/content/manuals/engine/install/raspberry-pi-os.md b/content/manuals/engine/install/raspberry-pi-os.md
index fbdd26ed96..9a18d26284 100644
--- a/content/manuals/engine/install/raspberry-pi-os.md
+++ b/content/manuals/engine/install/raspberry-pi-os.md
@@ -1,10 +1,10 @@
 ---
 description: Learn how to install Docker Engine on a 32-bit Raspberry Pi OS system. These instructions cover
-  the different installation methods, how to uninstall, and next steps.
+  the different installation methods, how to uninstall, and next steps. Note that 32-bit support will be deprecated in Docker Engine v29 and later.
 keywords: requirements, apt, installation, install docker engine, Raspberry Pi OS, install, uninstall, upgrade,
-  update
-title: Install Docker Engine on Raspberry Pi OS (32-bit)
-linkTitle: Raspberry Pi OS (32-bit)
+  update, deprecated
+title: Install Docker Engine on Raspberry Pi OS (32-bit / armhf)
+linkTitle: Raspberry Pi OS (32-bit / armhf) 
 weight: 50
 toc_max: 4
 aliases:
@@ -13,6 +13,14 @@ aliases:
 download-url-base: https://download.docker.com/linux/raspbian
 ---
 
+> [!WARNING]
+>
+> Raspberry Pi OS 32-bit (armhf) will soon be deprecated. Starting with Docker Engine v29,
+> new major versions will no longer provide packages for Raspberry Pi OS 32-bit (armhf).
+>
+> It is recommended to migrate to the 64-bit version of Raspberry Pi OS, which
+> is supported and follows the [Debian installation instructions](debian.md).
+
 To get started with Docker Engine on Raspberry Pi OS, make sure you
 [meet the prerequisites](#prerequisites), and then follow the
 [installation steps](#installation-methods).
@@ -49,6 +57,15 @@ To install Docker Engine, you need one of the following OS versions:
 - 32-bit Raspberry Pi OS Bookworm 12 (stable)
 - 32-bit Raspberry Pi OS Bullseye 11 (oldstable)
 
+> [!WARNING]
+>
+> Support for 32-bit (armhf) Raspberry Pi OS will soon end. Docker Engine versions
+> prior to v29 will continue to work, but new major versions starting with
+> v29 will no longer provide 32-bit packages.
+>
+> Switch to 64-bit Raspberry Pi OS and follow
+> the [Debian installation instructions](debian.md) for continued support.
+
 ### Uninstall old versions
 
 Before you can install Docker Engine, you need to uninstall any conflicting packages.