Automatically keeps your Flatpak NVIDIA runtime in sync with your system NVIDIA driver on Fedora.
When Fedora updates your NVIDIA driver (via DNF/Discover), your Flatpak apps still reference the old NVIDIA runtime version. This causes errors like:
Failed to get OpenGL information. Make sure your GPU drivers are properly installed.
This happens because DNF and Flatpak are completely separate ecosystems — they don't talk to each other. You have to manually install the new matching Flatpak NVIDIA runtime and remove the old one every time your driver updates. This tool fixes that.
There are two layers of protection:
Layer 1 — DNF hook (primary fix): Runs the sync automatically the moment DNF finishes installing or updating your NVIDIA driver. By the time you reboot, your Flatpak runtime is already updated and the error popup never appears.
Layer 2 — Systemd service (safety net): Runs on every boot and cleans up any leftover mismatched runtimes in case the DNF hook ever missed something.
Both layers log everything to /var/log/nvidia-flatpak-sync.log.
- Fedora (tested on Fedora 43 KDE)
- NVIDIA GPU with drivers installed via RPM Fusion
- Flatpak installed with Flathub configured
libdnf5-plugin-actions(installed automatically by install.sh)
git clone https://github.com/YOUR_USERNAME/nvidia-flatpak-sync.git
cd nvidia-flatpak-sync
chmod +x install.sh uninstall.sh nvidia-flatpak-sync.sh
sudo ./install.shThat's it. The service will run automatically on every boot from now on.
To see what the service has done:
cat /var/log/nvidia-flatpak-sync.logExample output after a driver update:
[2026-02-28 14:32:01] === NVIDIA Flatpak Sync Started ===
[2026-02-28 14:32:01] System NVIDIA driver version: 580.126.18
[2026-02-28 14:32:01] Expected flatpak runtime: org.freedesktop.Platform.GL.nvidia-580-126-18
[2026-02-28 14:32:01] Mismatch detected! Installing correct flatpak NVIDIA runtimes...
[2026-02-28 14:32:01] Installing org.freedesktop.Platform.GL.nvidia-580-126-18...
[2026-02-28 14:32:45] Successfully installed org.freedesktop.Platform.GL.nvidia-580-126-18
[2026-02-28 14:32:45] Installing org.freedesktop.Platform.GL32.nvidia-580-126-18...
[2026-02-28 14:33:10] Successfully installed org.freedesktop.Platform.GL32.nvidia-580-126-18
[2026-02-28 14:33:10] Removing old runtime: org.freedesktop.Platform.GL.nvidia-580-119-02
[2026-02-28 14:33:15] Successfully removed org.freedesktop.Platform.GL.nvidia-580-119-02
[2026-02-28 14:33:15] Removing old runtime: org.freedesktop.Platform.GL32.nvidia-580-119-02
[2026-02-28 14:33:20] Successfully removed org.freedesktop.Platform.GL32.nvidia-580-119-02
[2026-02-28 14:33:20] === Sync Complete ===
cd nvidia-flatpak-sync
chmod +x uninstall.sh
sudo ./uninstall.shIf you want to trigger a sync manually at any time:
sudo systemctl start nvidia-flatpak-sync.serviceA bash script (nvidia-flatpak-sync.sh) is installed to /usr/local/bin/ and a systemd service (nvidia-flatpak-sync.service) is enabled to run it at boot after network connectivity is established. The script uses modinfo nvidia to get the system driver version, converts it to Flatpak's naming format (dots to dashes), checks installed Flatpak runtimes, and installs/removes as needed.
Pull requests welcome! This was built to solve a real annoyance on Fedora with NVIDIA + Flatpak. If you've tested it on other distros or have improvements, feel free to open a PR.
MIT