Skip to content

Commit 1fe6c85

Browse files
authored
Add Raspnerry Pi boot order configuration (#593)
* Add Raspnerry Pi boot order coniguration * Remove last modified line after #595 * Minor corrections for typos and wording
1 parent 2ea5aaa commit 1fe6c85

File tree

1 file changed

+37
-3
lines changed

1 file changed

+37
-3
lines changed

docs/documentation/raspberry-pi.md

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
title: "Raspberry Pi"
33
---
44

5-
###### last modified: 2025-02-26
6-
75
# Raspberry Pi
86

97
## About Raspberry Pi
@@ -343,7 +341,43 @@ Add the following two lines at the bottom of `user-data` instead (example is dif
343341
+ - nmcli dev wifi connect "Wi-Fi_SSID" password "Wi-Fi_PreSharedKey"
344342
```
345343

346-
### Frequent Issues
344+
345+
## Configure Boot Order
346+
347+
In March 2025, the `rpi-eeprom` package was added, enabling the Raspberry Pi bootloader configuration, such as boot order, to be changed using only AlmaLinux. Here are the instructions on how to change the Raspberry Pi boot order.
348+
349+
The `rpi-eeprom` tool is an optional package that is not pre-installed in our Raspberry Pi images. Install it if you wish to configure the Raspberry Pi boot order.
350+
351+
```shell
352+
dnf install -y rpi-eeprom
353+
```
354+
355+
Run `rpi-eeprom-config` command with the `-e` (edit) option. The editor will open, letting you edit the bootconfiguration.
356+
Refer to [the official documentation](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#BOOT_ORDER) for the meaning of `BOOT_ORDER` and detailed examples.
357+
358+
```shell
359+
rpi-eeprom-config -e
360+
```
361+
362+
The following example attempts to boot from the SD card first, followed by a USB mass storage device, and then NVMe. To boot from a USB mass storage device first, move `4` to the rightmost position, `0xf614`.
363+
364+
```ini
365+
[all]
366+
BOOT_UART=1
367+
POWER_OFF_ON_HALT=0
368+
BOOT_ORDER=0xf641
369+
```
370+
371+
After saving the changes and exiting the editor, the following message will be displayed. Raspberry Pi will boot up with the new order after reboot.
372+
373+
```
374+
(ommitted)
375+
376+
EEPROM updates pending. Please reboot to apply the update.
377+
To cancel a pending update run "sudo rpi-eeprom-update -r".
378+
```
379+
380+
## Frequent Issues
347381
348382
If you installed a GUI, and your screen has a black border around it, follow the steps below to fix this:
349383

0 commit comments

Comments
 (0)