Template:Fedup upgrade procedure

1. Do a full system update and reboot
2. Install the latest version of fedup from the stable or updates repository
3. Find the repository URL for the TC or RC you are testing. This should be of the form https://dl.fedoraproject.org/pub/alt/stage/<compose>/Server/<arch>/os/ - you can use the Server or Workstation tree, the upgrade image is the same
   • <compose> is the TC/RC you are testing - e.g. 21_Beta_TC1
   • <arch> is the name of the arch running on the install to be upgraded (i386, x86_64 ...)
4. Start the upgrade prep by executing following command
   • sudo fedup --network <version> --instrepo <URL> --product=<desired product>
   • <version> is the version of Fedora you are upgrading to (currently 41)
   • <URL> is the location found in the previous step
   • <desired product> is the Fedora Product you want to upgrade to ('workstation' if you had GNOME installed, for example)
5. If you need to use a local mirror to test a brand new change, start the upgrade prep by executing the following command:
   • su -c 'fedup --network <version> --instrepo <URL> --disablerepo=fedora --repourl fedora-local=<URL-LOCAL>'
   • <URL-LOCAL> is the location of a local fedora repo if needed for faster response speeds
6. Check /var/log/fedup.log file to see if any errors show up in the output from fedup
7. Reboot the system if fedup has completed without error
8. Once the system reboots, there should be a new entry in the GRUB menu titled System Upgrade
9. Select the System Upgrade option from the GRUB menu
10. The system should boot into the upgrade process and a fedup progress screen should be displayed
    • Pressing the <ESC> key should switch from the graphical progress screen to the text progress information display
11. Once the upgrade process has completed, the system will reboot and an option to boot Fedora 41 will be on the grub menu
12. Log in to upgraded system, open a terminal, file browser, or other system applications.