# 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
```