From Fedora Project Wiki

Revision as of 19:31, 1 November 2016 by Adamwill (talk | contribs) (add an EOL upgrade section)

Upgrading with DNF system upgrade plugin

Recommended Upgrade Method
This is the recommended method for upgrades of all Fedora installs except Fedora Atomic Host.

For instructions on upgrading with the DNF system upgrade plugin, refer to the dedicated page.

Online rebases for Fedora Atomic Host via rpm-ostree

Recommended Upgrade Method for Atomic Host
This is the recommended method for upgrades of Fedora Atomic Host installations.

For instructions on upgrading Fedora Atomic Host installations between Fedora releases, refer to the dedicated page.

Online upgrade with pure DNF

Not a recommended upgrade method
This is NOT an officially recommended method for Fedora upgrades.

Upgrading from one release to the next using dnf directly, without the DNF system upgrade plugin, is not explicitly tested by Fedora QA and issues with it are not considered blockers for a release, but in practice it works for many users. To learn more, refer to Upgrading Fedora using dnf.

Updating from a pre-release (Alpha, Beta, or other development snapshot) to the final release

If you are using a pre-release of Fedora, and want to know more about upgrading to the final release, refer to Upgrading from pre-release to final. This is not technically an 'upgrade' operation, it is simply an update, but there are some special considerations involved in making sure you stay on the update track you intend to use, which are documented on this page.


  • Ensure you have a good backup of your data.
  • Ensure you read the Release Notes carefully before attempting an upgrade.

Upgrading to Rawhide and Branched

Rawhide and Branched are the development releases of Fedora. They are suitable for people who are developing or testing Fedora before broad public release. They are NOT SUITABLE for regular day-to-day use unless you are a fairly experienced user, and certainly not suitable for mission-critical use. You should read through those pages carefully before deciding to run Branched or, particularly, Rawhide. See Fedora Release Life Cycle for more information on how the whole Fedora cycle works from Rawhide, to Branched, to the milestone releases (Alpha and Beta), to a 'final' release.

If you are sure you want to do it, upgrading to a Branched release or to Rawhide can be done with DNF system upgrade just like upgrading to a newer stable release. There are just a couple of special notes that are covered in the instructions.

Upgrading from End of life releases

Note that Fedora strongly recommends against ever running an end-of-life release on any production system, or any system connected to the public internet, in any circumstances. You should never allow a production Fedora deployment to reach end-of-life in the first place.

With that in mind, if you do have an end-of-life release installed on a system you cannot just discard or re-deploy, you can attempt to upgrade it, though this is not officially tested or supported.

If you have Fedora 21 or later, you can try to upgrade using DNF_system_upgrade#eol.

If you have Fedora 20 or earlier, you will have to perform at least part of the upgrade with bare dnf or yum. You can either use that method to upgrade to Fedora 21 or later and then use DNF_system_upgrade to upgrade from there to a currently-supported release, or just use bare dnf or yum for the entire upgrade process.

Note that when upgrading from Fedora 20 or earlier, you are both upgrading from an end-of-life release and using a not-officially-recommended upgrade mechanism; such upgrades are very much performed 'at your own risk' and may well require various kinds of manual intervention to run and clean up the upgraded system, if they work at all.