From e4a8bfcedb674b9ea1fe2fe1f430c8ee5efbcf58 Mon Sep 17 00:00:00 2001 From: Igor Date: Fri, 5 Dec 2025 21:03:28 +0100 Subject: [PATCH 1/4] Add flashing Armbian images section to user guide Added instructions for flashing Armbian images from a running system. --- docs/User-Guide_Getting-Started.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/User-Guide_Getting-Started.md b/docs/User-Guide_Getting-Started.md index 4366dd63c..e377f37b7 100644 --- a/docs/User-Guide_Getting-Started.md +++ b/docs/User-Guide_Getting-Started.md @@ -395,6 +395,19 @@ For novice users, a sensible default is `ext4`. Congratulation. You have successfully installed Armbian onto your board! +## Flashing Armbian images from a running system + +!!! note + Armbian also provides a tool to **download, verify, and flash OS images** + directly to SD cards, USB drives, eMMC, SSD, or NVMe storage — without using + another computer. + + This is useful when: + - preparing new boot media + - reinstalling or recovering a broken system + - switching to another Armbian variant or kernel branch + + [The tool](/User-Guide_Armbian-Config/System/#download-and-flash) works on any device running **Armbian** or any compatible **Debian/Ubuntu** system. ## Update the system From ac7b3f5493d70614e61e1001009a83cbcc6b8df8 Mon Sep 17 00:00:00 2001 From: Igor Date: Fri, 5 Dec 2025 21:12:56 +0100 Subject: [PATCH 2/4] Fix checksum command URL and enhance deployment section Corrected the URL in the checksum command and added a note about the Armbian imager. --- docs/User-Guide_Getting-Started.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/User-Guide_Getting-Started.md b/docs/User-Guide_Getting-Started.md index e377f37b7..bc363b194 100644 --- a/docs/User-Guide_Getting-Started.md +++ b/docs/User-Guide_Getting-Started.md @@ -125,7 +125,7 @@ After you have downloaded these files, we recommend checking the integrity and t On Windows, you can download and use the [QuickHash GUI](https://www.quickhash-gui.org/download/quickhash-v3-1-0-windows/) and follow the instructions in the gui. Linux and macOS users can simply do this in the directory with the compressed image and the checksum file: ```sh - sha256sum -c Armbian_25.2.1_Bananapicm4io_bookworm_current_6.12.13_minimal.img.xz.sha + sha256sum -c Armbian_25.2.1_Bananahttps://docs.armbian.compicm4io_bookworm_current_6.12.13_minimal.img.xz.sha ``` The integrity is verified if the output looks something like this: @@ -179,6 +179,8 @@ There are multiple ways to deploy the image to your board. The easiest and most ### Flash to SD Card +[Armbian imager](/User-Guide_Armbian-Config/System/#download-and-flash) works on any device running **Armbian** or any compatible **Debian/Ubuntu** system and can download, flash and verify. + Write the **.xz compressed image** with a tool like [USBImager](https://gitlab.com/bztsrc/usbimager) onto your **micro-SD card** or **USB drive** (if booting from it is supported). Unlike other tools, it can validate written data **saving you from corrupted SD card contents**. !!! warning "Other tools" @@ -264,7 +266,7 @@ If you used an SD card insert it into a slot and power on the board. With the ch ## First login The first boot will log you in automatically if you have connected a display via HDMI or if you are connected to the serial console. For SSH, you need to login as **root** and use the password **1234**. If you need to find your board's IP address, you can use [this tool](https://angryip.org/). - +https://docs.armbian.com After logging in, you will be prompted to change the default password. You will then be asked to create a normal user account that will have sudo permissions. Beware, at this stage, the keyboard is using the QWERTY layout. In case you have no wired network connection and there is a wireless adaptor detected, the system will prompt you to connect. Welcome to Armbian! @@ -398,11 +400,10 @@ Congratulation. You have successfully installed Armbian onto your board! ## Flashing Armbian images from a running system !!! note - Armbian also provides a tool to **download, verify, and flash OS images** - directly to SD cards, USB drives, eMMC, SSD, or NVMe storage — without using - another computer. + Armbian also provides a tool to **download, verify, and flash OS images** directly to SD cards, USB drives, eMMC, SSD, or NVMe storage — without using another computer. This is useful when: + - preparing new boot media - reinstalling or recovering a broken system - switching to another Armbian variant or kernel branch From b1ca39c0a3a1070913138cf1b00689a587b6fafc Mon Sep 17 00:00:00 2001 From: Igor Date: Fri, 5 Dec 2025 21:21:34 +0100 Subject: [PATCH 3/4] Update User-Guide_Getting-Started.md --- docs/User-Guide_Getting-Started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/User-Guide_Getting-Started.md b/docs/User-Guide_Getting-Started.md index bc363b194..92a5b2937 100644 --- a/docs/User-Guide_Getting-Started.md +++ b/docs/User-Guide_Getting-Started.md @@ -125,7 +125,7 @@ After you have downloaded these files, we recommend checking the integrity and t On Windows, you can download and use the [QuickHash GUI](https://www.quickhash-gui.org/download/quickhash-v3-1-0-windows/) and follow the instructions in the gui. Linux and macOS users can simply do this in the directory with the compressed image and the checksum file: ```sh - sha256sum -c Armbian_25.2.1_Bananahttps://docs.armbian.compicm4io_bookworm_current_6.12.13_minimal.img.xz.sha + sha256sum -c Armbian_25.2.1_Bananapicm4io_bookworm_current_6.12.13_minimal.img.xz.sha ``` The integrity is verified if the output looks something like this: From 065bf578ea3452951298dc0b87622ec0d24e5158 Mon Sep 17 00:00:00 2001 From: Igor Date: Fri, 5 Dec 2025 21:22:49 +0100 Subject: [PATCH 4/4] Revise first login section in user guide Updated first login instructions and added a link to Armbian documentation. --- docs/User-Guide_Getting-Started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/User-Guide_Getting-Started.md b/docs/User-Guide_Getting-Started.md index 92a5b2937..abe511747 100644 --- a/docs/User-Guide_Getting-Started.md +++ b/docs/User-Guide_Getting-Started.md @@ -266,7 +266,7 @@ If you used an SD card insert it into a slot and power on the board. With the ch ## First login The first boot will log you in automatically if you have connected a display via HDMI or if you are connected to the serial console. For SSH, you need to login as **root** and use the password **1234**. If you need to find your board's IP address, you can use [this tool](https://angryip.org/). -https://docs.armbian.com + After logging in, you will be prompted to change the default password. You will then be asked to create a normal user account that will have sudo permissions. Beware, at this stage, the keyboard is using the QWERTY layout. In case you have no wired network connection and there is a wireless adaptor detected, the system will prompt you to connect. Welcome to Armbian!