In the world of Linux, package management is everything. For decades, the ecosystem was fragmented. You had .deb packages for Debian/Ubuntu, .rpm packages for Fedora/openSUSE, and the Arch User Repository (AUR) for Arch. While powerful, this system had flaws: apps could be outdated on stable distros (like Debian), and dependencies could conflict.
Enter Flatpak.
Flatpak is a universal package format that runs on virtually any Linux distribution. It’s sandboxed (more secure), bundles all its dependencies (no more “dependency hell”), and allows developers to deliver the latest version of their app directly to you.
But Flatpak is just the technology. To get the apps, you need a repository. Flathub is the “app store” for Flatpak. It’s a massive, centralized repository that hosts thousands of apps, from Spotify and Steam to advanced tools like OBS Studio and Blender.
Learning how to setup Flathub on Linux is the single most important step you can take to unlock the full software potential of your new system. This guide will show you how to do it on four major distributions.
The “One Command” to Add Flathub
In most cases, once the flatpak tool is installed, adding the Flathub repository is done with one universal command. The real work is making sure the core flatpak tool and any graphical-interface plugins are installed first.
The universal command to add the repository is:
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
After running this (and the steps below), you should restart your computer to ensure your Software Center (like GNOME Software or KDE Discover) fully detects the new repository.
How to Setup Flathub on Your Distribution
We’ve broken down the exact, verified steps for Fedora, Debian, Arch, and openSUSE. Find your distro and follow along.
1. How to Setup Flathub on Fedora
The Good News: Fedora is the easiest, as it embraces Flatpak by default.
Fedora Workstation (with GNOME) comes with Flatpak installed. The only step is to enable Flathub.
The Easy GUI Method (Recommended for Beginners)
This is the simplest way.
- Open the GNOME Software app.
- If this is your first time, it will automatically offer to enable “Third-Party Repositories.”
- Click Enable.
- This will enable Flathub (and other sources, like the NVIDIA driver repo). You’re done.
The Manual Command-Line Method
If you missed the initial prompt, or if you prefer the terminal, you can use the universal command.
- Open your Terminal.
- Run the command:Bash
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo - Restart your system.
2. How to Setup Flathub on Debian 12/13
The Good News: It’s rock-solid once set up, but it requires a few extra steps.
Debian, by default, is famously minimal. You need to install the Flatpak tool and a plugin to make it integrate with your software center.
Step 1: Install the Flatpak Package
Open a terminal and run the following command to install the main tool:
sudo apt install flatpak
Step 2: Install the Software Center Plugin (CRITICAL!)
This is the step most beginners miss. Without this, your graphical Software app won’t be able to “see” or manage Flatpaks.
- For GNOME (Default Debian Desktop):Bash
sudo apt install gnome-software-plugin-flatpak - For KDE Plasma:Bash
sudo apt install plasma-discover-backend-flatpak
Step 3: Add the Flathub Repository
Now, run the universal command to add the Flathub “app store”:
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
4: Restart
Reboot your computer. When you log back in, your Software Center will be fully populated with apps from Flathub.
3. How to Setup Flathub on Arch Linux
The Good News: As an Arch user, you’re used to a “Do-It-Yourself” approach, and this is no different. It’s clean and simple.
Step 1: Install Flatpak
Use pacman to install the main package:
sudo pacman -S flatpak
Step 2: Install the Desktop Portal (CRITICAL!)
Flatpaks are sandboxed, which means they need a “portal” to communicate with the rest of your desktop (e.g., to open a file). Arch does not install this by default. Without it, your Flatpaks will feel broken.
- For GNOME, XFCE, Cinnamon, or MATE:Bash
sudo pacman -S xdg-desktop-portal-gtk - For KDE Plasma:Bash
sudo pacman -S xdg-desktop-portal-kde
Step 3: Add the Flathub Repository
Now, add the Flathub repository:
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Step 4: Restart
Reboot your system to make sure the desktop portals and all services are running correctly.
4. How to Setup Flathub on openSUSE (Tumbleweed & Leap)
The Good News: The process is simple, clean, and very reliable.
Step 1: Install Flatpak
Use zypper to install the main package:
Bash
sudo zypper install flatpak
Step 2: Add the Flathub Repository
Use the universal command to add the Flathub “app store”:
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Step 3: Restart
Reboot your system. When you log back in, your Software Center (GNOME or KDE Discover) will be ready.
You may also read:
How to Use Flathub After Setup
Now that you’re configured, how do you get apps?
The Graphical Method (Easy)
Just open your Software Center (e.g., GNOME Software or KDE Discover). You can now search for any app, like “Spotify” or “Steam,” and you’ll see the Flathub version available to install with one click. Look for the “Source” dropdown to ensure you’re picking the Flatpak version if multiple options exist.
The Command-Line Method (Fast)
You can also manage your Flatpaks entirely from the terminal.
- To Search for an app:Bash
flatpak search steam - To Install an app:Bash
flatpak install flathub org.mozilla.firefox - To Run an app:Bash
flatpak run org.mozilla.firefox - To Update all your Flatpaks:Bash
flatpak update
Conclusion
Enabling Flathub is no longer an “optional” step for a modern Linux desktop; it’s essential. It provides access to the largest, most up-to-date, and most secure library of applications available. By following these simple, distro-specific steps, you have unlocked the true power and potential of your Linux machine.
For more information, you can always visit the FLATHUB OFFICIAL WEBSITE.
What’s the first app you’re going to install from Flathub? Did you run into any trouble? Let us know in the comments below!