From 1532bc170b4f9a8709603a538c016effb15026ac Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 19 Mar 2026 14:10:27 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20clarify=20Docker=20install=20=E2=80=94?=
 =?UTF-8?q?=20add=20docker.io=20fallback,=20warn=20against=20bare=20apt=20?=
 =?UTF-8?q?install=20docker-ce?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://claude.ai/code/session_01FKCW3FDjNFj6jve4niMFXH
---
 docs/setup.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/setup.md b/docs/setup.md
index 4e6d780..915bbdd 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -111,8 +111,25 @@ sudo systemctl enable fail2ban --now
 
 ## 5. Install Docker
 
+> **Note:** Do **not** run `apt install docker-ce` directly — that package
+> requires Docker's own apt repository to be added first.
+> Use one of the two methods below.
+
+**Option A — Official convenience script (recommended, installs latest Docker CE):**
+
 ```bash
 curl -fsSL https://get.docker.com | sh
+```
+
+**Option B — Debian-packaged `docker.io` (older but simpler, no extra repo needed):**
+
+```bash
+sudo apt install -y docker.io
+```
+
+Then, regardless of which option you used:
+
+```bash
 sudo usermod -aG docker pi   # allow running docker without sudo
 newgrp docker                # apply group without logging out
 docker run --rm hello-world  # verify