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
Copy file name to clipboardExpand all lines: docs/User-Guide_Armbian-Config/System.md
+34-8Lines changed: 34 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -654,36 +654,62 @@ Distribution upgrade to latest stable / LTS
654
654
655
655
656
656
<!--- header START from tools/include/markdown/STD001-header.md --->
657
-
Long-Term Support (LTS) upgradesprovide a**well-tested and stablerelease** ofthe underlying Linux distribution (Debian or Ubuntu). These versions receive**security patches and critical bug fixes** for an extended period, making them therecommended choice forproduction systems and users who prioritize stability over new features.
657
+
Stable /LTS upgradesmove your system to a newerrelease of Debian or Ubuntu, bringing updated system packages along with long-term security fixes and bug patches. This makes them thesafest choice forreliable, everyday use.
658
658
659
-
!!!Note
659
+
!!!Warning "Risks of Stable Upgrades"
660
660
661
-
While LTS upgrades are considered safe, always back up your data before proceeding with a distribution upgrade.
661
+
Distribution upgrades are experimental and **not supported by Armbian**. Use at your own risk.
662
+
663
+
Even LTS → LTS upgrades (e.g., **Debian Bookworm → Trixie**, **Ubuntu Jammy → Noble**) carry some risks:
664
+
665
+
- **Broken dependencies** – some packages may fail to upgrade or be removed.
666
+
- **Configuration overrides** – local changes may be replaced by defaults.
667
+
- **Downtime** – failed upgrades may require console access, manual recovery, or a full reinstall.
668
+
669
+
Because Armbian integrates upstream Debian/Ubuntu with custom board support packages, upgrades may still trigger **unexpected breakage** on some devices.
662
670
663
671
<!--- header STOP from tools/include/markdown/STD001-header.md --->
4.**Ensure you have console access** (serial, HDMI + keyboard, SSH).
691
+
5.**Consider fresh installs** if uptime and stability matter more than keeping the old environment.
692
+
693
+
<!--- footer STOP from tools/include/markdown/STD001-footer.md --->
694
+
695
+
673
696
####Unstable Distro Upgrade
674
697
675
698
676
699
Distribution upgrade to rolling unstable
677
700
678
701
679
702
<!--- header START from tools/include/markdown/UNS001-header.md --->
680
-
Testing upgrades track the**latest distribution releases** that are not yet fully stabilized. They include**new features, packages, and improvements**, but may also introduce regressions or breaking changes. This option is best suited for**developers, testers, and enthusiasts** who want early access and are willing to troubleshoot issues.
681
-
682
-
!!! Warning
703
+
Non-LTS releases are intended for**developers, testers, and enthusiasts** who want the latest features —**not for production systems**.
683
704
684
-
Testing upgrades may cause system instability. Avoid using this option on production devices. Always back up important data before upgrading.
705
+
!!! Warning "Risks of Unstable Upgrades"
685
706
707
+
Distribution upgrades are experimental and **not supported by Armbian**. Use at your own risk.
686
708
709
+
- **High chance of breakage** – dependencies, bootloader, or kernel may fail.