How to Install Flatpak on Debian

Tested on Debian 13 (trixie)
Package flatpak
Applies to Debian
Privilege sudo or root
Scope Install Flatpak on Debian, including the Flathub remote, sandboxed apps, update, Flatpak cleanly from system, and user scope.
Related guides Add Apt Repository Command Not Found
Apt Install Specific Version
Backup Brave Browser Session Ubuntu
Check Ubuntu Version
Configure Vnc Server Ubuntu

Flatpak installs sandboxed desktop applications from remotes such as Flathub—Firefox, Steam, GIMP, and thousands of others—without mixing their dependencies into APT. On Debian, you install the flatpak package from main, add the Flathub remote once, then run flatpak install (official Debian setup, Debian Wiki — Flatpak).

This guide covers install Flatpak on Debian for Debian 11 (Bullseye), 12 (Bookworm), and 13 (Trixie): install flatpak, configure Flathub, install apps (system or user scope), optional GNOME Software integration, update, and uninstall. I ran these steps on Debian 13 and kept real terminal output below. For apps you can also install through other channels, see install Firefox on Debian and install Steam on Debian.

NOTE
Flatpak apps are separate from .deb packages—apt list --installed does not show them. Use flatpak list alongside list installed packages on Debian for a full software inventory.

Choose an install path

Step Purpose On test host
apt install flatpak Flatpak CLI and system integration 1.16.6-1~deb13u1
flatpak install flathub APP Install sandboxed apps + runtimes Flatseal, Spider
gnome-software-plugin-flatpak (optional) Install/update Flatpaks in GNOME Software Available in apt, not required

There is no separate flatpak third-party repository for current Debian releases—flatpak comes from Debian main on Bookworm and Trixie.

Flatpak on Debian releases

Debian Codename Typical source
13 trixie apt install flatpak (main)
12 bookworm apt install flatpak (main)

Check what is installed

List files shipped by a package with dpkg -L; the dpkg command shows how to locate binaries and configuration paths.

bash
. /etc/os-release && echo "$PRETTY_NAME"
command -v flatpak || echo "flatpak: not installed"
flatpak --version 2>/dev/null
flatpak remote-list 2>/dev/null
dpkg -l flatpak 2>/dev/null | grep ^ii

Before install on the test host:

text
Debian GNU/Linux 13 (trixie)
flatpak: not installed

After apt install flatpak:

text
Flatpak 1.16.6
flathub	system
ii  flatpak  1.16.6-1~deb13u1  amd64  Application deployment framework for desktop apps

Prerequisites

  • Debian 11, 12, or 13 on amd64 or arm64 with a desktop session (GNOME, KDE, Xfce, etc.) for GUI apps.
  • sudo for system-wide installs and the flatpak package.
  • Outbound HTTPS to deb.debian.org and dl.flathub.org.
  • xdg-desktop-portal (often pre-installed on desktops) so sandboxed apps can open files and URLs—xdg-desktop-portal-gtk on GTK desktops.

Commands below that need root use sudo command.

bash
dpkg -l xdg-desktop-portal xdg-desktop-portal-gtk 2>/dev/null | grep ^ii
text
ii  xdg-desktop-portal      1.20.3+ds-1
ii  xdg-desktop-portal-gtk  1.15.3-1

Disk space: a single app plus runtimes used about 1.7 GB under /var/lib/flatpak on the test host—plan more for games or IDEs.

  • For broader CLI reference beyond the apt and sudo steps below, see the Linux commands.

Install Flatpak from Debian apt

Per flatpak.org — Debian:

bash
sudo apt update
sudo apt install -y flatpak
text
Selecting previously unselected package flatpak.
Unpacking flatpak (1.16.6-1~deb13u1) ...
Setting up flatpak (1.16.6-1~deb13u1) ...

Verify:

List every PATH match with which -a; the which command compares which to type -a and command -v.

bash
flatpak --version
which flatpak
text
Flatpak 1.16.6
/usr/bin/flatpak

Log out and back in (or reboot) after the first install if your desktop’s app menu does not show new Flatpaks—Flathub’s Debian notes mention this for some sessions.


Add the Flathub remote

Flathub is the default application store for Flatpak:

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

Search before installing:

bash
flatpak search firefox | head -3
text
Firefox	Fast, Private & Safe Web Browser	org.mozilla.firefox	152.0.3	stable	flathub

Install Flatpak applications

System-wide install (all users)

Use sudo so apps land in /var/lib/flatpak:

bash
sudo flatpak install -y flathub com.github.tchx84.Flatseal
flatpak list --app
text
Flatseal	com.github.tchx84.Flatseal	2.4.1	stable	system

Flatseal is a small permissions manager—useful for testing Flatpak without downloading a large browser.

Per-user install

For installs under ~/.local/share/flatpak without root:

bash
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user -y flathub io.github.zaedus.spider
flatpak list --user
text
Spider	io.github.zaedus.spider	0.0.7	stable
IMPORTANT
If flatpak install --user reports No remote refs found for 'flathub', you added Flathub only at system scope. Run flatpak remote-add --user as shown above.

Examples: Firefox and Steam

bash
sudo flatpak install -y flathub org.mozilla.firefox
flatpak run org.mozilla.firefox --version

See install Firefox on Debian for firefox-esr, Mozilla APT, and Snap comparisons.

bash
sudo flatpak install -y flathub com.valvesoftware.Steam
flatpak run com.valvesoftware.Steam

Steam via Flatpak is covered in install Steam on Debian.

Launch and inspect apps

bash
flatpak run com.github.tchx84.Flatseal
flatpak info com.github.tchx84.Flatseal | head -12
text
Flatseal - Manage Flatpak permissions

          ID: com.github.tchx84.Flatseal
         Ref: app/com.github.tchx84.Flatseal/x86_64/stable
     Version: 2.4.1
      Origin: flathub
Installation: system

GNOME Software integration (optional)

On GNOME, install the Flatpak plugin so Software can browse Flathub:

bash
sudo apt install -y gnome-software-plugin-flatpak

KDE users can install plasma-discover-backend-flatpak when using Discover. These packages are optional—the flatpak CLI works without them.


Update Flatpak and applications

Update installed Flatpaks

bash
flatpak update

When nothing is pending:

text
Looking for updates…
Nothing to do.

Update the flatpak package itself

bash
sudo apt update
sudo apt install --only-upgrade flatpak
flatpak --version

Uninstall Flatpak applications and the framework

Remove one app

bash
flatpak uninstall com.github.tchx84.Flatseal
flatpak uninstall --user io.github.zaedus.spider

Remove unused runtimes after deleting apps:

bash
flatpak uninstall --unused

Remove the flatpak package

bash
sudo apt purge flatpak
sudo apt autoremove --purge

Dry-run removing flatpak:

text
The following packages will be REMOVED:
  flatpak
Remv flatpak [1.16.6-1~deb13u1]

Delete leftover data

bash
sudo rm -rf /var/lib/flatpak
rm -rf ~/.local/share/flatpak

Installed Flatpak apps stop working if you delete these directories without uninstalling first.


Troubleshooting

Symptom Likely cause Fix
flatpak: command not found Package not installed sudo apt install flatpak
error: No remote refs found for 'flathub' (user install) Flathub missing at user scope flatpak remote-add --user … flathub.flatpakrepo
App missing from menu after install Session cache Log out/in; run update-desktop-database
Blank window / no file picker Portal not installed sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk
Very large disk use under /var/lib/flatpak Shared runtimes per app flatpak uninstall --unused; remove apps you do not need

References


Summary

Install Flatpak on Debian with sudo apt install flatpak, add Flathub via flatpak remote-add, and install apps with flatpak install flathub APP_ID. Use system scope (sudo) or --user scope for per-account installs—add Flathub at the matching scope. Update apps with flatpak update, list them with flatpak list, and remove flatpak plus /var/lib/flatpak when you no longer need sandboxed packages.


Frequently Asked Questions

1. How do I install Flatpak on Debian?

Run sudo apt update && sudo apt install flatpak, then flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo. Install apps with flatpak install flathub APP_ID.

2. How do I install Flatpak apps on Debian?

After Flathub is configured, run flatpak install flathub org.mozilla.firefox or search with flatpak search NAME. Use sudo flatpak install for system-wide installs or flatpak install --user for per-user installs under ~/.local/share/flatpak.

3. Is Flatpak in Debian repositories?

Yes. Debian 12 and 13 ship flatpak in main. Debian 11 (bullseye) users may need bullseye-backports for a current flatpak package—see wiki.debian.org/Flatpak.

4. What is the difference between system and user Flatpak installs?

sudo flatpak install stores apps in /var/lib/flatpak for all users. flatpak install --user stores under ~/.local/share/flatpak and requires flatpak remote-add --user for Flathub. Pick one scope per machine policy.

5. Do I need Flathub to use Flatpak on Debian?

Flatpak works without Flathub, but most desktop apps live on Flathub. Add the flathub remote once—official setup is documented at flatpak.org/setup/Debian.

6. How do I update Flatpak apps on Debian?

Run flatpak update to refresh all installed apps and runtimes. The flatpak Debian package itself updates through apt: sudo apt install --only-upgrade flatpak.

7. Why does flatpak install --user say no remote refs?

Flathub was added only for system scope. Run flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo before flatpak install --user.

8. How do I uninstall Flatpak from Debian?

Remove apps with flatpak uninstall APP_ID, then sudo apt purge flatpak. Delete /var/lib/flatpak and ~/.local/share/flatpak if you want all runtimes gone.
Deepak Prasad

R&D Engineer

Founder of GoLinuxCloud with more than 15 years of expertise in Linux, Python, Go, Laravel, DevOps, Kubernetes, Git, Shell scripting, OpenShift, AWS, Networking, and Security. With extensive experience, he excels across development, DevOps, networking, and security, delivering robust and efficient solutions for diverse projects.

  • Go (programming language)
  • Python (programming language)
  • DevOps
  • Computer Security
  • Cloud Computing
  • Kubernetes
  • Linux
  • Ansible (software)