Skip to content

Commit e754eba

Browse files
igorpecovnikgithub-actions[bot]
authored andcommitted
Automatic documentation update
1 parent 1b65b50 commit e754eba

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed

docs/User-Guide_Armbian-Config/System.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,9 @@ __Documentation:__ [Link](https://forum.armbian.com/)
172172
#### Install
173173

174174

175+
Copy live OS to internal media
176+
177+
175178
<!--- header START from tools/include/markdown/STO001-header.md --->
176179
This section provides an option to transfer the live running Armbian system from an SD card to internal storage devices such as eMMC, SATA, NVMe, or USB drives. It prepares the target storage, copies the active system, adjusts bootloader settings, and ensures the system can boot independently without requiring reinstallation.
177180

@@ -188,6 +191,75 @@ armbian-config --cmd STO001
188191
~~~
189192

190193

194+
#### Download and flash
195+
196+
197+
Download and flash to internal media
198+
199+
200+
<!--- header START from tools/include/markdown/FLASH1-header.md --->
201+
# Flashing Armbian Images from Within the System
202+
### Prepare bootable media or flash internal storage using **armbian-config**
203+
204+
Armbian includes a tool for browsing, downloading, and flashing official OS images directly to SD cards, USB drives, or internal eMMC.
205+
It works on **any Armbian installation** and on **any Debian/Ubuntu-compatible Linux system**, allowing you to prepare boot media for *any supported board* from *any compatible device*.
206+
207+
---
208+
209+
## Features
210+
211+
### Image Selection
212+
- Browse the entire official Armbian image list
213+
- Filter by preinstalled applications, kernel branch, image variant, and stability
214+
- Promoted images marked with ★
215+
- Automatically hides non-flashable formats (e.g. qcow2)
216+
- Shows image size in MB
217+
218+
### Safe Device Handling
219+
To prevent accidental data loss, the tool automatically hides devices containing:
220+
- `/` (root filesystem)
221+
- `/boot`
222+
- `/boot/efi`
223+
224+
Only non-system block devices are selectable flash targets.
225+
226+
---
227+
228+
## When to Use
229+
230+
- Installing Armbian to internal eMMC/SSD
231+
- Preparing SD/USB boot media
232+
- Recovering or re-flashing devices
233+
- Switching OS variants or kernel branches
234+
- Rapid deployment and testing scenarios
235+
<!--- header STOP from tools/include/markdown/FLASH1-header.md --->
236+
237+
__Edit:__ [footer](https://github.com/armbian/configng/edit/main/tools/include/markdown/FLASH1-footer.md) [header](https://github.com/armbian/configng/edit/main/tools/include/markdown/FLASH1-header.md)
238+
__Status:__ Preview
239+
__Architecture:__ <span style="background-color:#e0e0e0; color:#333333; padding:3px 6px; border-radius:4px; font-size:90%;">x86-64</span> <span style="background-color:#d3f9d8; color:#1b5e20; padding:3px 6px; border-radius:4px; font-size:90%;">arm64</span> <span style="background-color:#fff3bf; color:#7c4d00; padding:3px 6px; border-radius:4px; font-size:90%;">armhf</span>
240+
__Maintainer:__ @igorpecovnik
241+
__Documentation:__ [Link](https://docs.armbian.com/User-Guide_Recovery/)
242+
243+
~~~ custombash
244+
armbian-config --cmd FLASH1
245+
~~~
246+
247+
248+
<!--- footer START from tools/include/markdown/FLASH1-footer.md --->
249+
### Download and Flash Process
250+
251+
The workflow includes:
252+
253+
1. **Downloading the selected image** using `file_url`
254+
2. **On-the-fly decompression** (`.img.xz → .img`)
255+
3. **Progress indication** using `pv` + whiptail gauges when available
256+
4. **Fallback text progress** when minimal tools are installed
257+
5. **Writing to the selected storage device**
258+
6. Optional **post-flash verification** to confirm data integrity
259+
7. User choice to **Reboot**, **Shut down**, or **Exit**
260+
<!--- footer STOP from tools/include/markdown/FLASH1-footer.md --->
261+
262+
191263
#### Read Only FS
192264

193265

0 commit comments

Comments
 (0)