From a528a29a4e83ae37fa90f2cf479d3e27be93d688 Mon Sep 17 00:00:00 2001
From: piratebird <141295458+Piratebird@users.noreply.github.com>
Date: Wed, 20 May 2026 04:59:00 +0200
Subject: [PATCH] dnf-system-upgrade: add page (#22487)

---
 pages/linux/dnf-system-upgrade.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/linux/dnf-system-upgrade.md

diff --git a/pages/linux/dnf-system-upgrade.md b/pages/linux/dnf-system-upgrade.md
new file mode 100644
index 0000000000..5b5e2b5ba5
--- /dev/null
+++ b/pages/linux/dnf-system-upgrade.md
@@ -0,0 +1,28 @@
+# dnf system-upgrade
+
+> Upgrade Fedora to a new major release.
+> More information: <https://dnf5.readthedocs.io/en/latest/commands/system-upgrade.8.html>.
+
+- Prepare the system by upgrading all installed packages:
+
+`sudo dnf upgrade --refresh`
+
+- Download packages required for the new release version:
+
+`sudo dnf system-upgrade download --releasever {{release_version}}`
+
+- Reboot and start the upgrade process:
+
+`sudo dnf system-upgrade reboot`
+
+- Display the status of the current upgrade transaction:
+
+`sudo dnf system-upgrade status`
+
+- Display logs from previous upgrade attempts:
+
+`sudo dnf system-upgrade log`
+
+- Remove cached upgrade data and packages:
+
+`sudo dnf system-upgrade clean`