From Gentoo Wiki
Jump to:navigation Jump to:search

Flatpak is a package management framework for Linux desktop applications. It aims to provide support for sandboxed, distro-agnostic binary packages.



USE flags for sys-apps/flatpak Linux application sandboxing and distribution framework

doc Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally
gtk Add support for x11-libs/gtk+ (The GIMP Toolkit)
introspection Add support for GObject based introspection
kde Add support for software made by KDE, a free software community
policykit Enable PolicyKit (polkit) authentication support
seccomp Enable seccomp (secure computing mode) to perform system call filtering at runtime to increase security of programs
systemd Enable use of systemd-specific libraries and features like socket activation or session tracking


Chromium-based browsers suggest disabling suid USE-flag for sys-apps/bubblewrap for performance reasons.
Flatpak installation guide suggested to restart the system after installation. This might be no longer necessary.
root #emerge --ask sys-apps/flatpak

Add flathub repository

All operations with flatpak can be performed as user or as root.
user $flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo


  • /var/lib/flatpak - global flatpak state (system-wide installed apps and repos)
  • ~/.local/share/flatpak - per-user flatpak state (locally installed apps and repos)
  • ~/.var/app/ - per application state (configuration files and cache)

Basic usage

To install an application, e.g. Thunderbird, run:

user $flatpak install org.mozilla.Thunderbird

To run the application use created .desktop file or run:

user $flatpak run org.mozilla.Thunderbird

To update installed applications and runtimes:

user $flatpak update