Skip to content

Getting Started

FriendlyHub is a Flatpak repository that works with any Linux distribution that supports Flatpak. You can use it alongside Flathub or any other Flatpak remote with no conflicts.

Installing Flatpak

If you're using any of the following distributions, Flatpak is already installed and you can skip to the next step:

AlmaLinux, CentOS Stream, elementary OS, Fedora, Linux Mint, Pop!_OS, Solus, Zorin OS

If your distribution isn't listed above, you'll need to install Flatpak first. Choose your distribution below for instructions:

Adding the FriendlyHub Remote

Open a terminal and run:

bash
flatpak remote-add --if-not-exists friendlyhub https://dl.friendlyhub.org/repo/friendlyhub.flatpakrepo

This downloads the repository configuration and GPG key. The --if-not-exists flag means it's safe to run even if you've already added it.

Alternatively, you can download the friendlyhub.flatpakrepo file and open it with GNOME Software or your system's Flatpak handler.

Browsing Apps

On the Web

Visit friendlyhub.org/apps to browse all available apps. Each app page shows screenshots, a description, permissions, and install instructions.

From the Terminal

List all available apps:

bash
flatpak remote-ls friendlyhub

Search for a specific app:

bash
flatpak search --columns=application,remotes "search term" | grep friendlyhub

Installing Apps

From the Terminal

bash
flatpak install friendlyhub org.example.MyApp

From GNOME Software or KDE Discover

Once you've added the FriendlyHub remote, apps from FriendlyHub will appear in your software centre's search results alongside apps from other remotes. You can also click the Install button on any app's page on the FriendlyHub website, which opens a .flatpakref link that your software centre can handle directly.

Updating Apps

Update all apps from all remotes (including FriendlyHub):

bash
flatpak update

Or update a specific app:

bash
flatpak update org.example.MyApp

GNOME Software and KDE Discover will also show available updates from FriendlyHub in their normal update flow.

Running Alongside Flathub

FriendlyHub is a standard Flatpak remote. It coexists with Flathub and any other remotes without conflict. If the same app is available on multiple remotes, Flatpak will ask which remote you want to install from.

Removing the Remote

If you ever want to remove FriendlyHub:

bash
flatpak remote-delete friendlyhub

This removes the remote configuration but does not uninstall any apps you've already installed from it. To uninstall an app first:

bash
flatpak uninstall org.example.MyApp
flatpak remote-delete friendlyhub