Skip to content

docs: fix install options on the Raspberry Pi OS 32-bit page - #26087

Open
sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-raspberry-pi-install-options
Open

sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-raspberry-pi-install-options

Conversation

@sunm2n

@sunm2n sunm2n commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Description

Two problems on the Raspberry Pi OS (32-bit / armhf) install page, both
reported in #26082.

Docker Desktop isn't a supported option here. It was listed first under
"Installation methods" as "the easiest and quickest way to get started", but
Docker Desktop for Linux
only provides packages for x86_64 / amd64. The supported platforms table has
no ARM column, and the page doesn't mention ARM anywhere. Both 32-bit and
64-bit Raspberry Pi OS are ARM, so neither qualifies. Removed from the list.

The 32-bit migration path had no link. Both deprecation notices offer
Debian packages as the migration path, and the 64-bit entry links to the
Debian installation instructions. The 32-bit entry doesn't, so a reader is
told to "install the Debian armhf packages" with nowhere to go. That matters
here because this page installs from the raspbian repository
(download-url-base in the front matter), not the Debian one, so the notice
can't be read as pointing at the instructions further down this page. Added
the same link to the 32-bit entry in both notices.

debian.md lists armhf (arm/v7) among its supported architectures and
includes armhf in its package selection step, so the link lands somewhere
that covers this case.

Related issues or tickets

Fixes #26082

Reviews

  • Technical review
  • Editorial review
  • Product review

Docker Desktop was listed first as "the easiest and quickest way to get
started", but Docker Desktop for Linux only ships packages for x86_64 /
amd64. It doesn't support Raspberry Pi: both 32-bit and 64-bit Raspberry Pi
OS are ARM. Remove it from the list of installation methods.

The deprecation notices offer Debian packages as the migration path. The
64-bit entry links to the Debian installation instructions but the 32-bit
entry does not, which leaves readers without a way to follow it. This page
installs from the raspbian repository, not the Debian one. Add the same link
to the 32-bit entry in both notices.

Fixes docker#26082

Signed-off-by: Sunmin Lee <134378502+sunm2n@users.noreply.github.com>
@sunm2n
sunm2n requested a review from dvdksn as a code owner September 14, 2026 04:42
@netlify

netlify Bot commented Sep 14, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit c940197
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6aa77b53d244700008af9548
😎 Deploy Preview https://deploy-preview-26087--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/engine Issue affects Docker engine/daemon area/install Relates to installing a product labels Sep 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/engine Issue affects Docker engine/daemon area/install Relates to installing a product

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Confusing for RasPi 32bit

1 participant