Ошибка no remote refs found similar to flathub

In this article, we will see how to solve «No remote refs found similar to ‘flathub’» error. Last night when I was trying to install an application from flathub repository using flatpak utility, I noticed this error on the output and then I decided to write a post about this while fixing this error so that it will help you folks as well in case if you are also facing the same error. But before that let’s understand few key things first in case you are not already aware of.

What is Flatpak

Flatpak is a software deployment and package management utility that allows user to deploy and run their application in a sandboxed or an isolated environment. It was written in C language with an aim to provide a runtime environment for applications which works in isolation with the host system.

What is Flathub

Flathub is an app store very much similar to snap store, which contains hundreds of apps that can be installed on any Linux environment using flatpak utility. You can check more about this on official website.

Also Read: How to Install Flameshot Screenshot Tool on Ubuntu 20.04 LTS (Focal Fossa)

So I was trying to install Komikku manga reader application on my Ubuntu 20.04 LTS system from flathub repository using flatpak utility then I noticed "No remote refs found similar to ‘flathub’" error on the output as shown below.

root@cyberithub:~# flatpak install flathub info.febvre.Komikku
Looking for matches…
error: No remote refs found similar to ‘flathub’

While the above error could occur due to any reasons but in most of the cases it is because flathub repo remote URL is not added. Since flatpak search and download all the applications from flathub repo so without the repo URL added it won’t able to find any reference to flathub where it can search the application. This you can also verify by running below flatpak remotes command. It will show you blank output.

root@cyberithub:~# flatpak remotes

So to fix the "No remote refs found similar to ‘flathub’" error, you need to add flathub repo URL using below flatpak remote-add command. You can check 21 Popular Flatpak command examples on Linux to understand the usage of flatpak utility.

root@cyberithub:~# flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Now again if you check the remote flathub repo using flatpak remotes command, you will see it added as below .

root@cyberithub:~# flatpak remotes
Name    Options
flathub system

This should fix the error. To verify you can try to install the application again by using same flatpak install flathub info.febvre.Komikku command as shown below. You can notice that this time it works as expected and it is now able to proceed with the installation.

root@cyberithub:~# flatpak install flathub info.febvre.Komikku
Looking for matches…
Required runtime for info.febvre.Komikku/x86_64/stable (runtime/org.gnome.Platform/x86_64/41) found in remote flathub
Do you want to install it? [Y/n]: Y

info.febvre.Komikku permissions:
ipc network fallback-x11 wayland x11 dri file access [1] dbus access [2]

[1] xdg-pictures
[2] org.freedesktop.Notifications, org.freedesktop.secrets, org.gnome.SettingsDaemon.Color


ID Branch Op Remote Download
1. [✓] info.febvre.Komikku.Locale stable i flathub 2.6 kB / 268.2 kB
2. [|] org.freedesktop.Platform.GL.default 21.08 i flathub 16.7 MB / 131.3 MB
3. [ ] org.freedesktop.Platform.openh264 2.0 i flathub < 1.5 MB
4. [ ] org.gnome.Platform.Locale 41 i flathub < 336.5 MB (partial)
5. [ ] org.gnome.Platform 41 i flathub < 291.0 MB
6. [ ] info.febvre.Komikku stable i flathub < 9.0 MB

Installing 2/6… ███▍ 17% 16.7 MB/s

Hope this will help you fixing your issue as well. Please let me know your feedback on comment box.

Flathub’s regular branch works perfect on my system but after following the readme attached to this repo I can’t finish the installation of the Flatpak due to above error the result of flatpak remotes shows its installed

Name         Options
fedora       system,oci
flathub      system
flathub-beta system
winepak      system

           /:-------------:          solojazz@hardware
        :-------------------::        OS: Fedora 
      :-----------/shhOHbmp---:      Kernel: x86_64 Linux 5.1.5-300.fc30.x86_64
    /-----------omMMMNNNMMD  ---:     Uptime: 10m
   :-----------sMMMMNMNMP.    ---:    Packages: 1671
  :-----------:MMMdP-------    ---   Shell: bash 5.0.7
 ,------------:MMMd--------    ---:   Resolution: 1920x1080
 :------------:MMMd-------    .---:   DE: GNOME 
 :----    oNMMMMMMMMMNho     .----:   WM: GNOME Shell
 :--     .+shhhMMMmhhy++   .------/   WM Theme: 
 :-    -------:MMMd--------------:    GTK Theme: Mojave-dark [GTK2/3]
 :-   --------/MMMd-------------;     Icon Theme: McMojave-circle-dark
 :-    ------/hMMMy------------:      Font: Cantarell 11
 :-- :dMNdhhdNMMNo------------;       CPU: Intel Core i7-3930K @ 12x 3.8GHz [34.0°C]
 :---:sdNMMMMNds:------------:        GPU: Radeon RX 580 Series (POLARIS10, DRM 3.30.0, 5.1.5-300.fc30.x86_64, LLVM 8.0.0)
 :------:://:-------------::          RAM: 2278MiB / 15977MiB
 :---------------------://       

Flatpak — это система для создания, распространения и запуска изолированных настольных приложений в Linux. Приложения можно устанавливать независимо от хост-системы, в которой они используются, и они в некоторой степени изолированы от хост-системы (изолированы) во время выполнения. Это позволяет пользоваться установленными приложениями вне зависимости от обновления хост-системы.

Установка flatpak

# apt-get install flatpak

Для установки приложений при помощи flatpak из-под непривилегированного пользователя следует добавить пользователя в группу fuse:

# gpasswd -a USER fuse

USER — имя Вашего пользователя

Добавление репозиториев

$ flatpak remote-add name_repository url

name_repository — название удаленного репозитория

url — url адрес репозитория

После подключения нового репозитория следует выполнить обновление его данных:

$ flatpak update

Пример:

$ flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo

Примечание: При подключении репозитория от пользователя входящего в группу wheel будет запрошен пароль root.

Удаление репозитория

$ flatpak remote-delete name_repository

name_repository — название удаляемого репозитория.

Список подключенных репозиториев

$ flatpak remotes

Поиск пакетов

Перед поиском следует выполнить обновление данных в репозитории:

$ flatpak update

Для поиска пакета:

$ flatpak search name_package

name_package — название Вашего пакета.

Получение списка пакетов в репозитории:

$ flatpak remote-ls name_repository

name_repository — название репозитория

Установка приложений

$ flatpak install name_repository name_package

Например:

$ flatpak install flathub firefox

Примечание: Если пакет содержит несколько версий терминал выведет меню выбора версий.
Некоторые приложения требует другую среду выполнения она будет загружена автоматически.

Файлы размещаются по адресу:

~/.local/share/flatpak

Список установленных приложений

$ flatpak list

Запуск-удаление-обновление приложений

Запуска приложения:

$ flatpak run appname

где appname, имя приложения вида org.unknown_horizons.UnknownHorizons (см. flathub.org)

Обновление приложения:

$ flatpak update name_package

Удаление приложения:

$ flatpak uninstall name_package

Удаление неиспользуемых пакетов

$ flatpak uninstall --unused

Просмотр и определение разрешений

Flatpak использует стандартный набор правил песочницы, которые определяют ресурсы и пути файловой системы для приложений. Чтобы просмотреть разрешения конкретного приложения необходимо узнать его ID:

$ flatpak list | grep name_package

Затем посмотреть разрешения:

$ flatpak info --show-permissions application_id

Список доступных параметров для разрешений Вы можете найти в документации flatpak.

Изменить разрешения можно командой:

# flatpak override permission_option application_id

Например:

# flatpak override --device=dri org.mozilla.firefox

Сбросить разрешения до стандартных:

# flatpak override --reset application_id

Управление flatpak из GUI

Первый способ

Для установки, обновления и удаления ПО из графического интерфейса используется Центр программ Discover.
В настройках Discover → Добавить репозиторий flathub.

Можно использовать web-интерфейс. Выбрать приложение скачать для него ярлык и запустить, Discover автоматически перехватит управление, добавит новый репозиторий и начнет установку.

Второй способ

Открываем Менеджер пакетов Synaptic, устанавливаем пакет flatpak-repo-flathub, также установиться и сам flatpak.

Открываем Центр управления системой, в меню Локальные группы находим группу fuse и добавляем нашего юзера в Члены группы. После этого перезапускаем текущую сессию.

После запуска Discover пройдет обновление репозитариев, в том числе и flathub, о чем нам покажет сообщение при запуске, затем можно пользоваться обычным поиском для установки нужных flatpak прямо в Discover.

На примере Spotify — запустить его можно командой flatpak run com.spotify.Client. Чтобы не запускать через терминал, а из меню, нужно добавить ярлык Spotify с помощью символьной ссылки в /.local/share/applications:

ln -s /var/lib/flatpak/app/com.spotify.Client/current/active/export/share/applications/com.spotify.Client.desktop /home/USER/.local/share/applications

На что обратить внимание в команде? — Расположение установленных программ в /var/lib/flatpak/app, на полный путь до ярлыка файл.desktop, а также имя своего пользователя указанного в примере — USER.

Если все сделано правильно в /.local/share/applications, мы увидим наш ярлык с именем com.spotify.Client.desktop, в меню появиться Spotify. Символьная ссылка работает так — ln -s /ЧТО /КУДА, для понимания команды выше.

Добавление в меню других программ аналогично.

Известные проблемы

Для установки приложений при помощи flatpak из-под непривилегированного пользователя следует добавить пользователя в группу fuse:

# gpasswd -a USER fuse

Примечание: При установке приложений через терминал, чтобы они появились в меню, необходимо перелогиниться.

Не найдено удаленных репозиториев

Внимание!
error: remote «flathub» not found

Внимание!
error: No remote refs found similar to ‘flathub’

Нет доступного репозитория их следует добавить.

$ flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo

Для второго случая:

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

Неправильное имя файла

Внимание!
error: Nothing matches io.brackets.Brackets.flatpakref in remote flathub

Неправильное название файла ярлыка.
Например: io.brackets.Brackets.flatpakref

Убрать из имени .flatpakref

Не удается смонтировать fuse fs

Внимание!
Can’t get document portal: GDBus.Error:org.freedesktop.portal.Error.Failed: Can’t mount fuse fs

Добавить пользователя в группу fuse

# gpasswd -a $USER fuse

Discover падает при добавлении новой программы

При этом Discover крашится.
Нет прав на монтирование файловой системы.

# control fusermount wheelonly

Нет соединения с интернетом

Внимание!
Не удалось получить список приложений. Проверьте соединение с интернетом

Discover сообщает об ошибке соединения с интернетом.
Следует установить пакет plasma5-discover-packagekit.

# plasma5-discover-packagekit
Перезапустить сеанс

Не добавляет ярлыки в меню приложений

Не добавляет ярлыки программ в меню приложений.
Сделать файл flatpak.sh исполняемым.

# chmod +x /etc/profile.d/flatpak.sh

Перезапустить сеанс. Это действие в DE kde вызывает вылет при загрузке.

Полезные ссылки

• Документация flatpak
• README проекта
• Web-интерфейс для поиска приложений
• Сайт разработчиков flatpak