server-desktop-01/docs/fedora-upgrade.md

71 lines
2.8 KiB
Markdown
Raw Normal View History

# Fedora release upgrades
Notes and decisions for distro version upgrades on this machine. The Hyprland
stack comes from the **solopasha COPR**, which is the recurring complication —
it must be rebuilt against the new Fedora release before the system upgrade can
resolve.
## Standard upgrade procedure
```bash
sudo dnf upgrade --refresh
sudo dnf install dnf-plugin-system-upgrade # usually already present
sudo dnf system-upgrade download --releasever=NN
sudo dnf system-upgrade reboot
```
## Status: Fedora 43 → 44 — DEFERRED (decided 2026-06-11)
**Decision: stay on Fedora 43 and wait. Do not upgrade to 44 yet.**
### Why deferred
`sudo dnf system-upgrade download --releasever=44` fails to resolve because the
solopasha COPR has **not rebuilt `aquamarine` against Fedora 44**:
- Fedora 44 ships `libdisplay-info-0.3.0`, which provides only `libdisplay-info.so.3`.
- The COPR's F44 build `aquamarine-0.9.5-2.fc44` still links against the old
`libdisplay-info.so.2` (verified — its `requires` list still names `.so.2`).
So it is uninstallable on F44.
- `hyprland` requires `aquamarine`, so it fails too.
- The old `libdisplay-info-0.2.0` cannot be kept — same package name (file
conflict), and `mutter` / `mesa-vulkan-drivers` / `wlroots` / `sway` all move
to `.so.3` versions on F44.
This is **the sole blocker**. Everything else in the transaction resolves
cleanly. It is a stale COPR rebuild, not a local misconfiguration. There is no
native Hyprland/aquamarine in Fedora 44's repos, so the COPR is the only source.
No strong reason to rush: F43 is fully supported and the current GNOME/Hyprland
setup works. Staying put until the COPR catches up.
### How to proceed next time (re-checking F44)
1. Refresh and re-attempt the resolve (no commitment — this only downloads):
```bash
sudo dnf upgrade --refresh
sudo dnf system-upgrade download --releasever=44
```
2. **If it resolves** (no `libdisplay-info.so.2` / aquamarine error): the COPR
has rebuilt. Proceed with `sudo dnf system-upgrade reboot`.
3. **If it still errors on aquamarine / `libdisplay-info.so.2`:** the COPR is
still behind. Quick check of the dep:
```bash
dnf repoquery --releasever=44 --repo='copr:*solopasha*' --requires aquamarine | grep display
```
`libdisplay-info.so.2` = still stale, keep waiting. `libdisplay-info.so.3` =
ready to upgrade.
### Override path (only if F44 becomes urgent)
Proceed now by temporarily dropping the Hyprland stack and running on the GNOME
fallback. Reinstall Hyprland from the COPR once it is rebuilt.
```bash
sudo dnf remove aquamarine hyprland hyprland-uwsm xdg-desktop-portal-hyprland
sudo dnf system-upgrade download --releasever=44
sudo dnf system-upgrade reboot
# after reboot into F44, log into GNOME; reinstall when COPR is ready:
# sudo dnf install hyprland hyprland-uwsm xdg-desktop-portal-hyprland
```