quick-docs/en-US/upgrading.adoc

= Upgrading

'''

[IMPORTANT]
======

This page was automatically converted from https://fedoraproject.org/wiki/Upgrading

It is probably

* Badly formatted
* Missing graphics and tables that do not convert well from mediawiki
* Out-of-date
* In need of other love


Pull requests accepted at https://pagure.io/fedora-docs/quick-docs

Once you've fixed this page, remove this notice, and update
`_topic_map.yml`.

Once the document is live, go to the original wiki page and replace its text
with the following macro:

....
{{#fedoradocs: https://docs.fedoraproject.org/whatever-the-of-this-new-page}}
....

======

'''


[[upgrading-fedora-workstation]]
Upgrading Fedora Workstation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Fedora Workstation 23 and later include a graphical system upgrade
mechanism. When a newer stable release is available, you should see a
graphical notification, similar to the ones you see for system updates.
Clicking this, or running the _Software_ application and going to the
_Updates_ pane, should show you a simple graphical interface for
upgrading the system. It will first download the upgrade files, then
prompt you to reboot the system and install them, again in similar
fashion to a system update. When the upgrade is complete, the system
will reboot again to the new release.

image:Upgradef24f25-gs.png[Upgradef24f25-gs.png,title="Upgradef24f25-gs.png",width=640]

[[upgrading-with-dnf-system-upgrade-plugin]]
Upgrading with DNF system upgrade plugin
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For instructions on upgrading with the DNF system upgrade plugin, refer
to link:DNF_system_upgrade[the dedicated page]. This mechanism can also
be used for Fedora Workstation upgrades if you prefer a command-line
tool or if you need to try and analyze some kind of package issue that
seems to be preventing the graphical method from working.

[[online-rebases-for-fedora-atomic-host-via-rpm-ostree]]
Online rebases for
https://getfedora.org/en/cloud/download/atomic.html[Fedora Atomic Host]
via rpm-ostree
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For instructions on upgrading Fedora Atomic Host installations between
Fedora releases, refer to link:Atomic_Host_upgrade[the dedicated page].

[[online-upgrade-with-pure-dnf]]
Online upgrade with pure DNF
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Upgrading from one release to the next using 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
link:Upgrading_Fedora_using_package_manager[Upgrading Fedora using dnf].

[[updating-from-a-pre-release-alpha-beta-or-other-development-snapshot-to-the-final-release]]
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
link:Upgrading_from_pre-release_to_final[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.

[[tips]]
Tips
~~~~

* Ensure you have a good backup of your data.

* Ensure you read the
http://docs.fedoraproject.org/en-US/Fedora/%7B%7BFedoraVersionNumber%7D%7D/html/Release_Notes/[Release
Notes] carefully before attempting an upgrade.

[[upgrading-to-rawhide-and-branched]]
Upgrading to Rawhide and Branched
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

link:Releases/Rawhide[Rawhide] and link:Releases/Branched[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 link:Fedora_Release_Life_Cycle[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 link:DNF_system_upgrade[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]]
Upgrading from link:End_of_life[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
link:DNF_system_upgrade#eol[DNF system upgrade].

If you have Fedora 20 or earlier, you will have to perform at least part
of the upgrade with
link:Upgrading_from_EOL_Fedora_using_package_manager[bare ]. You can
either use that method to upgrade to Fedora 21 or later and then use
link:DNF_system_upgrade[DNF system upgrade] to upgrade from there to a
currently-supported release, or just use bare or 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.

[[upgrading-using-the-fedora-installer-anaconda]]
Upgrading using the Fedora installer (anaconda)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Fedora releases up to Fedora 17 included upgrade functionality in the
Fedora installer, anaconda. This can be a better choice than
link:Upgrading_from_EOL_Fedora_using_package_manager[a package manager
upgrade] for some EOL upgrades, especially upgrades to Fedora Core 2,
Fedora Core 3, and Fedora 17. If you are attempting to upgrade from
Fedora 16 or older, it is highly recommended to upgrade to Fedora 16 and
then perform an installer upgrade from Fedora 16 to Fedora 17 before
upgrading any further.

To upgrade using the installer, boot the system from a network install
or DVD image for the target release, and run through the initial steps
of the install process. After you select storage devices - if your
install is located on a 'specialized' storage device, ensure to
configure and select it - the installer should offer you the option to
upgrade the installed system.
'''

See a typo, something missing or out of date, or anything else which can be
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.