FEDORA-UPGRADE(8)

💖 FEDORA-UPGRADE — the glow-up page 💖

okay bestie, welcome to fedora-upgrade, section 8 of the manuals (that's the "sysadmin commands" shelf, very main character of it). This is the tool that literally holds your hand and guides you through upgrading Fedora to the next major version using dnf. ✨

---

🌸 SYNOPSIS 🌸

fedora-upgrade [--help] [--tmpfs=SIZE] [--upgrade-to=VERSION]

---

🦋 DESCRIPTION 🦋

The script fedora-upgrade is out here trying to automate all the steps you'd need for a dnf-upgrade from one major version to the next one. Like, no cap, it does the whole run of show for you. 🎀

Here's the itinerary — the steps <rainbow>fedora-upgrade</rainbow> actually does:

• Display usual warnings. (yes, the scary ones, but she's gentle about it 💅)
• Check dependencies.
• Resolve old .rpmsave and .rpmnew files before upgrading (if there are some).
• Download and import RPM GPG keys.
• Run dnf --releasever=$TOVER distro-sync.
• Install missing packages from group Minimal Install.
• Resolve old .rpmsave and .rpmnew files after upgrade.
• Reset priorities of services.

Now the options, gorgeous:

• --tmpfs=SIZE — when you're doing an online upgrade and your /var/cache/dnf is looking a little ✨cramped✨, this option mounts /var/cache/dnf as tmpfs with the size you specify. The SIZE can be anything that the mount command accepts. E.g. "3G". The mount point gets unmounted when dnf finishes. Clean up after yourself, queen. 🧚
• -u=VERSION, --upgrade-to=VERSION — by default, fedora-upgrade upgrades to the next version. I.e. from 29 to 30. But you can specify which version you're going to upgrade to and jump from 28 to 30. Be warned though: this is hardly tested and there can be some issues. 😭 The VERSION is a number or the string "rawhide".

fr fr, that -u / --upgrade-to skip-a-version thing is highkey not battle-tested. Proceed with the energy of someone who has backups. 💀

---

👀 SEE ALSO 👀

• dnf(8)
• rpmconf(8)
• fedora-remove-old-gpg-keys(8)
• https://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager

---

🙈 BUGS 🙈

If you experience some problem (and bestie, we've all been there), please report it at:

• https://github.com/xsuchy/fedora-upgrade/issues

---

👑 AUTHOR 👑

Miroslav Suchý <msuchy@redhat.com> — icon, legend, the moment. 🫶

---

and that's a wrap on fedora-upgrade, page FEDORA-UPGRADE(8), dated 08/19/2026. go forth and upgrade, you absolute star ⭐🌈