Docs: recommend Raspberry Pi Imager instead of Etcher.
Some checks are pending
CodeQL / Analyze (push) Waiting to run
Controller Tests / controller-tests (push) Waiting to run
Jest Tests / jest-tests (push) Waiting to run

Etcher is privacy-invasive; replace it in INSTALL.md, the USB upgrade
tool messages, and the live-boot ephemeral warning.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Roland 2026-07-03 18:58:54 -06:00
parent 75cc0bbe6c
commit ebbc60992c
No known key found for this signature in database
GPG key ID: 1BA620CE6C9A4680
3 changed files with 5 additions and 5 deletions

View file

@ -25,7 +25,7 @@ You will need:
Steps:
1. Download the latest `WROLPi-v*-amd64.iso` from [wrolpi.org](https://wrolpi.org).
2. Flash the whole drive with the ISO using Etcher, Rufus, Raspberry Pi Imager, or `dd`:
2. Flash the whole drive with the ISO using Raspberry Pi Imager, Rufus, or `dd`:
```
sudo dd if=WROLPi-v<version>-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
```

View file

@ -59,7 +59,7 @@ progress "Preparing WROLPi..."
# --- Detect deployment mode ---------------------------------------------
# Three mutually-exclusive shapes:
#
# direct Live USB flashed with dd/Etcher: the ISO partition is a
# direct Live USB flashed with dd/Raspberry Pi Imager: the ISO partition is a
# real partition on a real disk. Create + manage a
# persistence partition on that disk.
#
@ -326,7 +326,7 @@ WROLPi can't safely write a persistence partition in that case, so
everything lives in RAM and will be lost when you reboot or power off.
To get a persistent install, flash the ISO directly to a USB drive
with dd or Etcher and boot from that drive instead.
with dd or Raspberry Pi Imager and boot from that drive instead.
EOF
else
cat > "$SUMMARY_FILE" <<EOF

View file

@ -165,7 +165,7 @@ ERROR: the new ISO is larger than the headroom on this USB.
To upgrade, you'll need to:
1. Back up /media/wrolpi/ to another drive.
2. Re-flash the new ISO from scratch with dd or Etcher.
2. Re-flash the new ISO from scratch with dd or Raspberry Pi Imager.
3. Restore /media/wrolpi/ from the backup.
Future versions flashed from a release ≥ 0.22 reserve 8 GiB of
@ -225,7 +225,7 @@ WROLPi USB without losing your files:
1. Back up everything on the drive to another disk.
2. Flash the whole drive with the ISO (this erases it):
sudo dd if=<iso> of=<device> bs=4M status=progress conv=fsync
(or use Etcher / Rufus / Raspberry Pi Imager)
(or use Raspberry Pi Imager / Rufus)
3. Boot the drive once. WROLPi creates its persistence partition and
sets itself up on first boot.
4. Copy your backed-up data into /media/wrolpi/ on the running system,