diff --git a/docs/flashing_os.md b/docs/flashing_os.md index 641c418b..2ab0a99e 100644 --- a/docs/flashing_os.md +++ b/docs/flashing_os.md @@ -27,37 +27,49 @@ Pre-compiled images are only available for the Raspberry Pi 4 and ZeroW. For all ### Using Linux CLI Decompress and flash the image. Be careful when choosing your device path: + ``` # xz --decompress v2-hdmi-rpi4-latest.img.xz # dd if=v2-hdmi-rpi4-latest.img of=/dev/mmcblkX ``` +You can also use `dd_rescue` or `ddrescue`. -### Using balenaEtcher (Linux, MacOS and Windows) -1. Download and install [balenaEtcher](https://www.balena.io/etcher). +### Using RPi Imager (Linux, MacOS and Windows) -2. Decompress the image file using your favorite archive software. If you don't have one that supports `.xz` files (on Windows for example) - [7-Zip](https://www.7-zip.org) is a great and free tool. **Do not try to flash a compressed image: it will not work.** +1. Download and install **the latest version** of [RPi Imager](https://github.com/raspberrypi/rpi-imager/releases). -3. Run balenaEtcher: +2. Run RPi Imager: - drawing + -4. Press **Flash from file** and select a **decompressed** image (a file with `.img` suffix): +3. Press **CHOOSE OS** and select **Use custom** image at bottom of the list: - drawing + -5. Insert the memory card into the card reader. Press **Select target** and choose your memory card: +4. After clicking on this item, select the image file (`.img.xz`), then click **CHOOSE STORAGE**: - drawing + -6. Press **Flash!** button. +5. Insert the memory card into the card reader. Choose the card reader from this list. **Be careful** and choose the right device: - drawing + -7. Wait for the process to finish. Get yourself a coffee or do some stretching :) If an error occurs during flashing, repeat the process: +6. After choosing the memory card, press the **WRITE** button. Confirm the operation when you are asked about it: - drawing + -!!! tip - If balenaEtcher does not work for you and you continue to get failed bootup's, download the [Raspberry Pi Imager](https://www.raspberrypi.com/software) and use that instead. The general algorithm of actions is exactly the same: use a decompressed image, run Imager, select a device and flash the image there. +7. Wait for the process to finish. Get yourself a coffee or do some stretching :) + + !!! tip + The process may hang at 99% for a long time, this is okay, just wait for it to complete + + + +8. Remove the memory card after successful completion: + + + + !!! tip + If an error occurs during flashing or booting PiKVM, repeat the process. diff --git a/docs/flashing_os/balena-1.png b/docs/flashing_os/balena-1.png deleted file mode 100644 index 6d7656e6..00000000 Binary files a/docs/flashing_os/balena-1.png and /dev/null differ diff --git a/docs/flashing_os/balena-2.png b/docs/flashing_os/balena-2.png deleted file mode 100644 index 2ecabf36..00000000 Binary files a/docs/flashing_os/balena-2.png and /dev/null differ diff --git a/docs/flashing_os/balena-3.png b/docs/flashing_os/balena-3.png deleted file mode 100644 index a50d984f..00000000 Binary files a/docs/flashing_os/balena-3.png and /dev/null differ diff --git a/docs/flashing_os/balena-4.png b/docs/flashing_os/balena-4.png deleted file mode 100644 index c40d342b..00000000 Binary files a/docs/flashing_os/balena-4.png and /dev/null differ diff --git a/docs/flashing_os/balena-5.png b/docs/flashing_os/balena-5.png deleted file mode 100644 index 3323d186..00000000 Binary files a/docs/flashing_os/balena-5.png and /dev/null differ diff --git a/docs/flashing_os/imager-1.jpg b/docs/flashing_os/imager-1.jpg new file mode 100644 index 00000000..c33179fa Binary files /dev/null and b/docs/flashing_os/imager-1.jpg differ diff --git a/docs/flashing_os/imager-2.jpg b/docs/flashing_os/imager-2.jpg new file mode 100644 index 00000000..4ddd48f8 Binary files /dev/null and b/docs/flashing_os/imager-2.jpg differ diff --git a/docs/flashing_os/imager-3.jpg b/docs/flashing_os/imager-3.jpg new file mode 100644 index 00000000..69b3e2a3 Binary files /dev/null and b/docs/flashing_os/imager-3.jpg differ diff --git a/docs/flashing_os/imager-4.jpg b/docs/flashing_os/imager-4.jpg new file mode 100644 index 00000000..61133f26 Binary files /dev/null and b/docs/flashing_os/imager-4.jpg differ diff --git a/docs/flashing_os/imager-5.jpg b/docs/flashing_os/imager-5.jpg new file mode 100644 index 00000000..e9f089b7 Binary files /dev/null and b/docs/flashing_os/imager-5.jpg differ diff --git a/docs/flashing_os/imager-6.jpg b/docs/flashing_os/imager-6.jpg new file mode 100644 index 00000000..a7fbe0e7 Binary files /dev/null and b/docs/flashing_os/imager-6.jpg differ diff --git a/docs/flashing_os/imager-7.jpg b/docs/flashing_os/imager-7.jpg new file mode 100644 index 00000000..7c14d862 Binary files /dev/null and b/docs/flashing_os/imager-7.jpg differ