OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
apps-services low common DISPUTE

Fix flatpak "No remote refs found similar to 'flathub'"

omarchyarchflatpak
AUDITED Audited against its sources and confirmed accurate. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

The Arch flatpak package file list includes usr/share/flatpak/remotes.d/flathub.flatpakrepo, and the Arch wiki says installing flatpak adds Flathub system-wide and gives the --user remote-add command used in the fix. The Flathub Discourse thread's answer states the cause verbatim: no flathub remote in the user installation, and the message is misleading because flatpak cannot tell a remote from a ref. flatpak is in neither Omarchy package list, so it is absent by default, and Omarchy's own GeForce NOW installer adds it with omarchy-pkg-add flatpak, the same command the fix uses. itsfoss supports the generic remote-add fix. Not exercised: flatpak commands, flatpak is not installed here.

Symptom

Installing anything from Flathub fails straight away:


error: No remote refs found similar to 'flathub'

It often happens with flatpak install --user ..., or inside a tool that installs runtimes per user (flatpak-builder from Flathub), even though flatpak install flathub ... worked another time.

Cause

flatpak looks the name up among the remotes of the installation it is using. Arch's flatpak package ships /usr/share/flatpak/remotes.d/flathub.flatpakrepo, so the system installation has Flathub out of the box, but the per-user installation (--user) starts with no remotes at all. The message is misleading because flatpak cannot tell whether flathub was meant as a remote or as an app or runtime name. On Omarchy flatpak is not installed by default, so it only appears once you add it.

Fix

See which installation has which remotes:


flatpak remotes --show-details
flatpak remotes --user
flatpak remotes --system

Add Flathub to the per-user installation:


flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Or to the system installation if it is missing there:


sudo flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Or simply drop --user and install system-wide. On Omarchy 4, install flatpak itself first with omarchy-pkg-add flatpak, then log out and back in so its apps reach the launcher.

Verify

flatpak remotes --user (or --system) lists flathub, and flatpak search spotify returns results.

Sources

flatpak-no-remote-refs-found-similar-to-flathub