What is Flatpak?

Flatpak makes it possible for users to install sandboxed applications on Linux distributions, in a way that is decoupled from the underlying operating system. It gives application developers the control on their agenda and the opportunity to publish new versions and updates without having to depend on a distribution's lifecycle.

The Flatpak system (previously known as xdg-app) uses a set of sandboxing technologies like OSTree and Linux cgroups to distribute software in a cross-distribution manner. These technologies isolate the Flatpak applications from each other and from the rest of the system, giving the user security benefits compared to downloading and installing unrestricted packages on their machine.

It has a concept of runtimes that applications can target to get a reliable and stable platform, independent of the underlying distribution. With runtimes, application developers can focus on their core work without needing to package lower level components and libraries while still having the control on their packaging and release cycle.

The official documentation has a more in depth introduction covering more details and underlying technologies.

Security Warning Note

Installing third party applications can be a security risk.

Be sure to use a trusted source like flathub.org or flatpak.org to get your applications of interest.

It is recommended to run such applications under a Wayland session that provides real isolation between graphical applications, unlike X.

Installing Flatpak

Flatpak is available in Debian from Stretch onwards.

It needs to be installed from backports in Jessie.

With Graphical Interface Support

Currently only Gnome Software supports Flatpak. You can install the Flatpak support plugin for Gnome Software with:

After this you’ll be able to navigate to a software repository like Flatpak.org/Applications and install applications directly from there.

Clicking on the download icon next to the application name will launch the installation. Your web browser should open a pop-up offering to open the file with the program "Install application".

Command Line

First install the flatpak package:

Then you’ll be able to install applications by calling:

where $source is the source repository for the application.

Users can install Flatpak applications on a per-user basis with the --user option:

Once installed, an application can be run with:

where $app_id is the source repository for the application.

Example, install current stable version of gedit:

See Flatpak/Applications/Command Line for more.


I get a "Not found org.gnome.Platform/x86_64/3.24" error message when trying to install an application

Unlike the flatpak command line interface, the Gnome Software Flatpak plugin currently doesn’t automatically install runtimes. Before installing applications, you’ll have to first install the necessary runtimes manually.

Applications currently available on flatpak.org target the gnome runtime. You may install it with the following command:

See runtimes for more available runtimes.