You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* 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]>
Copy file name to clipboardExpand all lines: docs/User-Guide_FAQ.md
+13-4Lines changed: 13 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -82,10 +82,19 @@ However, using the [**Armbian build framework**](https://docs.armbian.com/Develo
82
82
83
83
If enough users show interest in a specific configuration, we may **adjust build targets** accordingly.
84
84
85
-
## Can I upgrade my userspace flavor, like Bullseye to Bookworm or Jammy to Noble?
85
+
## Can I upgrade to a new Armbian release?
86
86
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.
88
88
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 Bookworm → Trixie or Jammy → Noble?
90
90
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