From 4b8aa4a619245b9f888bc58ea01f104d9916d8e5 Mon Sep 17 00:00:00 2001
From: Fredrik Ahlgren <fredrik@sourceful-labs.com>
Date: Tue, 29 Sep 2026 16:35:08 +0200
Subject: [PATCH] docs: separate the Pi card switch from Docker setup

---
 README.md  |  5 ++++-
 index.html | 11 ++++++-----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index cf2f99a..bcec0c9 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,10 @@ instead of copying version numbers or shell commands into this site.
 2.x and 3.x receive no more updates; recommend the new 0.x line. The old
 Pi image, one-line Docker installer and 3.x Home Assistant beta are not
 current install choices. Explain that a new setup is available now but guided
-transfer of old settings and history is not ready.
+transfer of old settings and history is not ready. For an existing Pi, put the
+physical SD-card swap before install commands. Present same-host Docker as a
+separate option for people who can manage its services, not the next step
+after a failed native install.
 
 ## Local dev
 
diff --git a/index.html b/index.html
index 0e64884..5d5e9a4 100644
--- a/index.html
+++ b/index.html
@@ -123,13 +123,14 @@ <h2>Install the new FTW 0.x beta.</h2>
         </div>
         <div class="release-note" role="note">
           <p><strong>2.x and 3.x will receive no further updates.</strong> Switch to the new 0.x line for current fixes and features. Do not install 3.x beta.</p>
-          <p>Already running FTW? Identify your installation first. You can switch with a new setup now; guided transfer of old settings and history is not ready. Keep your old data and run only one Core against your equipment.</p>
+          <p><strong>Old FTW on a Raspberry Pi? Use a second SD card.</strong> Keep the old card. Prepare the new one and swap cards before running install commands. Guided transfer of old settings and history is not ready.</p>
+          <p>Choose one path below. A refused native install is a stop point; do not try Docker next. Same-host Docker needs a planned switch with old Core stopped and MQTT preserved.</p>
         </div>
         <div class="start-links">
-          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#choose-your-path"><span>01</span>Switch or update FTW <b>Start here · all install types</b></a>
-          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#install"><span>02</span>Raspberry Pi / Linux <b>Fresh 64-bit host · native</b></a>
-          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#docker"><span>03</span>Docker on Linux <b>New 0.x release package</b></a>
-          <a href="https://github.com/srcfl/ftw#install-on-home-assistant"><span>04</span>Home Assistant users <b>New FTW on a separate host</b></a>
+          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#choose-your-path"><span aria-hidden="true">→</span>Switch or update FTW <b>Start here · all install types</b></a>
+          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#raspberry-pi-use-a-second-sd-card"><span aria-hidden="true">→</span>Switch an existing Pi <b>New SD card · step by step</b></a>
+          <a href="https://github.com/srcfl/ftw/blob/master/docs/native-beta.md#docker"><span aria-hidden="true">→</span>Docker on Linux <b>Separate path · Docker experience needed</b></a>
+          <a href="https://github.com/srcfl/ftw#install-on-home-assistant"><span aria-hidden="true">→</span>Home Assistant users <b>New FTW on a separate host</b></a>
         </div>
       </div>
     </section>