Skip to content

Commit b756f2e

Browse files
Update FAQ on upgrading Armbian releases (#827)
* Update FAQ on upgrading Armbian releases Revised FAQ section to clarify upgrade paths for Armbian releases and userspace flavors. * clarifications Clarify the upgrade process and support limitations for userspace flavors in Armbian. * Further clarifications and link to armbian-config section --------- Co-authored-by: Igor Pecovnik <[email protected]>
1 parent 5702c25 commit b756f2e

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

docs/User-Guide_FAQ.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -82,10 +82,19 @@ However, using the [**Armbian build framework**](https://docs.armbian.com/Develo
8282

8383
If enough users show interest in a specific configuration, we may **adjust build targets** accordingly.
8484

85-
## Can I upgrade my userspace flavor, like Bullseye to Bookworm or Jammy to Noble?
85+
## Can I upgrade to a new Armbian release?
8686

87-
Note: Upgrading Armbian core components (kernel, firmware, bootloader) and upgrading the chosen userspace are independent processes. The former is performed with `apt update && apt upgrade`.
87+
Yes! The simple `armbian-upgrade` command, which is an alias for `apt update && apt upgrade`, will upgrade **all Armbian-related core packages** (firmware, kernel, BSP) to the most recent version available — just as it will upgrade the underlying distribution packages.
8888

89-
Armbian does not provide a standardized userspace upgrade path (e.g., *Focal**Jammy*, *Jammy**Noble*, *Bullseye**Bookworm*, *Bookworm**Trixie*) nor encourages to do so. We would love to offer this, but we currently lack the resources (time and devices) to validate such upgrades across diverse scenarios.
89+
## Can I upgrade my userspace flavor, like BookwormTrixie or Jammy → Noble?
9090

91-
You may attempt a userspace upgrade using the official Debian/Ubuntu methods. Before doing so, freeze Armbian firmware/kernel/bootloader packages via [armbian-config](https://docs.armbian.com/User-Guide_Armbian-Config/). Note: issues arising from such upgrades are out of scope for Armbian support.
91+
Distribution upgrades (e.g. Bookworm → Trixie, Jammy → Noble) are **outside the scope of Armbian support**. If you attempt such an upgrade, we cannot assist if problems occur.
92+
93+
An **experimental upgrade option** is available in [armbian-config](https://docs.armbian.com/User-Guide_Armbian-Config/System/#stable-distro-upgrade), but it is provided *as-is* and without support.
94+
95+
Keep in mind:
96+
97+
- A distribution upgrade usually updates **all system packages**, which in 99% of cases come from the **upstream distribution (Debian/Ubuntu)**.
98+
- **Armbian firmware, kernel, and U-Boot are not part of this process**, which makes the upgrade generally safer from a hardware-support perspective.
99+
100+
If you decide to proceed, always ensure you have a **full backup of your system** so you can recover in case the upgrade fails.

0 commit comments

Comments
 (0)