Template:Fedup upgrade procedure

1. Do a full system update and reboot
2. Install fedup. It is usually a good idea to install the very latest version from updates-testing: su -c 'yum --enablerepo=updates-testing install fedup'
3. Find the URL of the development branch for Fedora 40. This URL should be of the form http://dl.fedoraproject.org/pub/fedora/linux/development/<version>/<arch>/os/
   • <version> is the of fedora under test (currently 40)
   • <arch> is the name of the arch running on the install to be upgraded (i386, x86_64 ...)
   • Due to the way that branched composes are done, the fedup client is not capable of grabbing initrd and kernel from those branches. The devel branch will rebuild from whatever is in stable for every push to the devel stable branch.
4. Start the upgrade prep by executing following command
   • su -c 'fedup-cli --network <version> --debuglog fedupdebug.log --instrepo <URL>'
   • <version> is the version of Fedora you are upgrading to (currently 40)
   • <URL> is the location found in the previous step
5. If you need to use a local mirror to test a brand new change, start the upgrade prep by executing following command:
   • su -c 'fedup-cli --network <version> --debuglog fedupdebug.log --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 the fedupdebug.log file to see if any errors show up in the output from fedup-cli
7. Reboot the system if fedup-cli 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
    • Press the <ESC> key, will switch from the graphical progress screen to the textual progress information display
      • Returning to the graphical progress screen by pressing the <ESC> key will return you to a screen where the progress bar is "frozen" RHBZ #873144 and RHBZ #883075, exist for this and other previous display issues related to fedup. Remove this comment once the bugs are confirmed fixed
11. Once the upgrade process has completed, the system will reboot and an option to boot Fedora 40 will be on the grub menu
12. Log in to upgraded system, open a terminal, file browser, or other system applications.