How to Install Flatpak on Debian (13, 12, 11)

Debian already includes Flatpak in the default repositories, so you can install Flatpak on Debian and run sandboxed desktop apps without replacing core system libraries. It is a practical way to use newer app releases while keeping dependencies isolated from your base OS.

After enabling Flathub system-wide, you can install apps through GNOME Software or KDE Discover, manage updates from the terminal, fix common Flatpak issues, and remove Flatpak cleanly if you decide not to keep it.

Update Debian Before Installing Flatpak

Before installing new packages, refresh the package index and apply available upgrades so Flatpak installs cleanly:

sudo apt update && sudo apt upgrade

This guide uses sudo for commands that need elevated privileges. If your account is not configured for sudo yet, follow how to add a user to sudoers on Debian.

Install Flatpak on Debian

Debian includes Flatpak in its standard repositories, but minimal or server installs often omit it. Install it with:

sudo apt install flatpak

Check the installed Flatpak version:

flatpak --version

Flatpak 1.16.2

Current package versions differ by Debian release. Debian 13 ships Flatpak 1.16.x, Debian 12 ships 1.14.x, and Debian 11 ships 1.10.x.

Add the Flathub Repository for Flatpak on Debian

Flathub is the primary repository for Flatpak applications, hosting thousands of applications from individual developers, open-source projects, and commercial vendors. To access these applications, add Flathub to your system:

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

This uses the system-wide remote so all users can access Flathub. The --if-not-exists flag avoids errors if the remote is already configured.

Confirm that Flatpak sees the Flathub remote:

flatpak remotes --system --columns=name

flathub

If flathub appears in the output, the system-wide remote is active.

Apply Flatpak Desktop Paths on Debian

Flatpak adds desktop entries under standard XDG (X Desktop Group) paths, but your session may cache menus. Log out and back in to reload the desktop session. If applications still do not appear, reboot once to refresh the menu cache:

sudo reboot

If you are on a server or minimal install without a desktop session, you can skip this step.

Install Flatpak Applications with GNOME Software on Debian

For users who prefer a graphical interface, GNOME Software provides an easy way to browse, install, and manage Flatpak applications. This section covers setup for GNOME desktop users. For additional GNOME customization options, see Install GNOME Tweaks on Debian.

Install the GNOME Software Flatpak Plugin on Debian

Install the Flatpak plugin so GNOME Software can display Flathub apps:

sudo apt install gnome-software-plugin-flatpak

After installation, restart GNOME Software or log out and back in for the plugin to take effect.

Browse and Install Flatpak Applications in GNOME Software

Once the plugin is active, open GNOME Software from your application menu (labeled “Software”). With the Flatpak plugin installed, you can now browse Flathub applications directly:

1. Use the search bar to find a specific application or browse categories.
2. Click an application to view its description, screenshots, and reviews.
3. Click “Install” to download and install the application.

Once installation completes, applications appear in your system’s application menu. From there, you can launch, update, or remove them through GNOME Software.

Install Flatpak Applications with KDE Discover on Debian

If you use KDE Plasma, Discover can manage Flatpak apps alongside Debian packages. If you still need the desktop environment, see Install KDE Plasma on Debian. Install the Flatpak backend:

sudo apt install plasma-discover-backend-flatpak

After installation, restart Discover or log out and back in. Flathub apps should then appear alongside Debian packages in search results.

Manage Flatpak Applications from Terminal on Debian

The Flatpak command-line interface gives you full control over application management and works on any Debian desktop environment.

Task	Command
Search Flathub apps	flatpak search <keyword>
Install system-wide	sudo flatpak install --system flathub <app-id>
Update installed apps	sudo flatpak update --system
Remove an app	sudo flatpak uninstall --system <app-id>

Search for Flatpak Applications

Use search to find applications by name or keyword:

flatpak search gimp

GIMP User Manual	GIMP User Manual	org.gimp.GIMP.Manual	2.10	2.10	flathub
GNU Image Manipulation Program	Create images and edit photographs	org.gimp.GIMP	3.0.8	stable	flathub
Resynthesizer	Resynthesizer GIMP Plugin	org.gimp.GIMP.Plugin.Resynthesizer	3.0	3	flathub

The results show tab-separated columns for name, description, application ID, version, branch, and remote. You might also see manuals or plugins, so use the third-column application ID (for example, org.gimp.GIMP) in install commands.

Install Flatpak Applications

Once you find an application, install it using the application ID from the search results:

sudo flatpak install --system flathub org.gimp.GIMP

During installation, Flatpak will prompt you to confirm and display any required runtimes that will be downloaded.

For full app-specific walkthroughs after setup, see Install Discord on Debian and Install Steam on Debian.

By default, using sudo installs applications system-wide, making them available to all users. To install for the current user only, drop sudo and add the --user flag: flatpak install --user flathub org.gimp.GIMP

View Flatpak Application Details

Preview package details from Flathub before installing:

flatpak remote-info flathub org.gimp.GIMP

GNU Image Manipulation Program - Create images and edit photographs

          ID: org.gimp.GIMP
         Ref: app/org.gimp.GIMP/x86_64/stable
        Arch: x86_64
      Branch: stable
           Version: 3.0.8
     License: GPL-3.0+ AND LGPL-3.0+
 Collection: org.flathub.Stable
     Runtime: org.gnome.Platform/x86_64/49
         ...

This output confirms the application ID, branch, runtime, and current release metadata published in Flathub. For installed apps, use flatpak info org.gimp.GIMP to inspect local details such as installation scope and commit state.

List Installed Flatpak Applications

List installed Flatpak applications:

flatpak list --app --system --columns=name,application,version,branch,installation

Expected output (example):

GNU Image Manipulation Program	org.gimp.GIMP	3.0.8	stable	system

The --app flag filters the output to show only applications, excluding runtimes and extensions. The final column shows the installation scope (for example, system for system-wide installs). If the list is empty, no Flatpak apps are installed yet.

Update Flatpak Applications

Update all installed Flatpak applications and runtimes:

sudo flatpak update --system

This updates all system-wide Flatpak apps and runtimes from every configured remote.

To update only one application:

sudo flatpak update --system org.gimp.GIMP

Remove Flatpak Applications

Remove a Flatpak application:

sudo flatpak uninstall --system org.gimp.GIMP

Clean up unused runtimes and dependencies:

sudo flatpak uninstall --system --unused

This command removes shared runtimes that are no longer required by any installed application, freeing disk space.

Run Flatpak Applications from Terminal

Launch a Flatpak application directly from the terminal:

flatpak run org.gimp.GIMP

Run this as your normal user (not with sudo). The app window should open, which is useful for debugging or when an application does not appear in your desktop menu.

Flatpak Application Data Location on Debian

Flatpak stores per-user data, configuration files, and cache in ~/.var/app/.

System-wide installs keep application files and runtimes under /var/lib/flatpak/, while each app’s user data still lives in ~/.var/app/<app-id>/ (for example, ~/.var/app/org.gimp.GIMP/).

Back up any directories you want to keep before a full removal.

Troubleshoot Common Flatpak Issues on Debian

Flatpak Search Returns No Matches

If flatpak search returns no results right after adding Flathub, local AppStream metadata is usually stale. On some systems you may also see a related lookup error.

No matches found
error: No remote refs found for 'flathub'

Refresh Flatpak metadata, confirm the remote exists, then repeat the search:

sudo flatpak update --system --appstream

flatpak remotes --system --columns=name

flatpak search gimp

GNU Image Manipulation Program	Create images and edit photographs	org.gimp.GIMP	3.0.8	stable	flathub

Flatpak Application Does Not Appear in Debian Menu

If a newly installed application does not appear in your desktop menu, the desktop environment may not have detected the new .desktop file. Confirm that the app is installed:

flatpak list --app --system --columns=name,application,version,branch,installation

Expected output (example):

GNU Image Manipulation Program	org.gimp.GIMP	3.0.8	stable	system

When the list is empty, reinstall the app:

sudo flatpak install --system flathub org.gimp.GIMP

Once the app appears, launch it from the terminal to confirm it works:

flatpak run org.gimp.GIMP

After it launches successfully, log out and back in to refresh the menu. If the menu still does not update, reboot once.

Flatpak Portal Errors on Debian

Flatpak applications use XDG Desktop Portals to interact with system features like file dialogs and screen sharing. If you see errors like the following when launching applications:

No portal found for org.freedesktop.portal.FileChooser
Failed to create portal proxy: No such interface

To fix this, install the portal package for your desktop environment:

sudo apt install xdg-desktop-portal-gtk

However, for KDE Plasma, install the KDE-specific portal instead:

sudo apt install xdg-desktop-portal-kde

After installing the portal package, log out and back in to start the portal services. Then verify the portal is running:

systemctl --user status xdg-desktop-portal

xdg-desktop-portal.service - Portal service
     Loaded: loaded
     Active: active (running)

Flatpak Permission Issues with Files or Devices

Flatpak applications run in sandboxes with limited filesystem access by default. If an application cannot access specific files or devices, you may see errors like:

Permission denied: /home/user/Documents/file.txt
Cannot access /dev/video0: Operation not permitted

The flatpak override command grants additional access. Grant only what you need, then verify the permission list. For example, to give GIMP access to your home directory:

flatpak override --user --filesystem=home org.gimp.GIMP

Verify that Flatpak applied the override:

flatpak info --show-permissions org.gimp.GIMP | grep filesystems

filesystems=xdg-config/GIMP:create;xdg-config/gtk-3.0;/tmp;xdg-run/gvfsd;host;xdg-run/gvfs;home;

If you want a quick refresher on filtering command output, see grep command in Linux with examples.

The --user flag applies the override for the current user only. To apply system-wide (for all users), replace --user with --system and run with sudo.

If you prefer a GUI for permission control, install Flatseal from Flathub.

Remove Flatpak from Debian

If you decide to remove Flatpak from your system, begin by uninstalling all Flatpak applications:

sudo flatpak uninstall --system --all

This removes every system-wide Flatpak app and runtime. Review the list when prompted before you confirm.

Remove the Flathub remote (and any other configured remotes):

sudo flatpak remote-delete --system flathub

Remove Flatpak and the software center plugins:

sudo apt remove --purge flatpak gnome-software-plugin-flatpak plasma-discover-backend-flatpak

Clean up orphaned dependencies:

sudo apt autoremove

Remove Flatpak User Data

Flatpak application data remains in ~/.var/app/ after uninstalling applications and Flatpak itself. To remove all Flatpak-related user data:

Warning: This permanently deletes all configuration, saves, and cache data for every Flatpak application. Back up any important data first. This action cannot be undone.

rm -rf ~/.var/app/

Remove System Flatpak Data

System-wide Flatpak apps and runtimes remain in /var/lib/flatpak/ after you remove the package. Remove this directory only if you no longer need any system-wide Flatpak apps or runtimes:

Warning: This permanently deletes all system-wide Flatpak apps and runtimes. If you want a backup, copy the directory first with sudo cp -a /var/lib/flatpak /var/lib/flatpak-backup.

sudo rm -rf /var/lib/flatpak

Verify Flatpak Removal

Finally, confirm Flatpak is no longer installed:

dpkg -l flatpak

dpkg-query: no packages found matching flatpak

If you see a row for flatpak, it is still installed and should be removed before proceeding.

Frequently Asked Questions About Flatpak on Debian

Conclusion

With Flatpak on Debian configured and Flathub enabled system-wide, app management is straightforward from GNOME Software, KDE Discover, or the terminal, without tangling app dependencies with core packages. For more desktop app choices, see Install Firefox on Debian or Install Snapd and Snap Store on Debian.