flatpak - Anwendungen und Laufzeitumgebungen erstellen, installieren und ausführen
SYNOPSIS
flatpak [OPTION...] {COMMAND}
DESCRIPTION
Flatpak ist ein Werkzeug zur Verwaltung von Anwendungen und den von ihnen verwendeten Laufzeitumgebungen. Im Flatpak-Modell können Anwendungen unabhängig vom Hostsystem, auf dem sie verwendet werden, erstellt und verteilt werden, und sie sind zur Laufzeit in gewissem Maße vom Hostsystem isoliert („Sandbox“).
Flatpak kann im systemweiten oder benutzerbezogenen Modus arbeiten. Die systemweiten Daten (Laufzeitumgebungen, Anwendungen und Konfiguration) befinden sich in $prefix/var/lib/flatpak/, und die benutzerbezogenen Daten befinden sich in $HOME/.local/share/flatpak/. Unterhalb dieser Speicherorte befindet sich ein lokales Repository im Unterverzeichnis repo/ und installierte Laufzeitumgebungen und Anwendungen befinden sich in den entsprechenden Unterverzeichnissen runtime/ bzw. app/.
Systemweite Remotes können statisch vorkonfiguriert werden, indem flatpakrepo(5)-Dateien in die Verzeichnisse /usr/share/flatpak/remotes.d/ und /etc/flatpak/remotes.d/ abgelegt werden. Wenn eine Datei mit demselben Namen in beiden Verzeichnissen vorhanden ist, hat die Datei unter /etc Vorrang.
Zusätzlich zur systemweiten Installation in $prefix/var/lib/flatpak/, die immer als Standard betrachtet wird, es sei denn, dies wird überschrieben, können weitere systemweite Installationen über Konfigurationsdateien in /etc/flatpak/installations.d/ definiert werden, die mindestens die ID der Installation und den absoluten Pfad zu dieser definieren müssen. Andere optionale Parameter wie DisplayName, Priority oder StorageType werden ebenfalls unterstützt.
Flatpak verwendet OSTree, um Daten zu verteilen und bereitzustellen. Die von ihm verwendeten Repositorys sind OSTree-Repositorys und können mit dem Dienstprogramm ostree bearbeitet werden. Installierte Laufzeitumgebungen und Anwendungen sind OSTree-Checkouts.
Grundlegende Befehle zum Erstellen von Flatpaks wie build-init, build und build-finish sind in dem Dienstprogramm flatpak enthalten. Für eine umfassendere Build-Unterstützung siehe das separate Dienstprogramm flatpak-builder(1).
Flatpak unterstützt die Installation aus Sideload-Repositorys. Dies sind partielle Kopien eines Repositorys (generiert durch flatpak create-usb), die als Installationsquelle verwendet werden, wenn keine Verbindung zum Internet besteht (und online als Leistungsverbesserung). Solche Repositorys werden konfiguriert, indem Symlinks zu den Sideload-Quellen im Unterverzeichnis sideload-repos des Installationsverzeichnisses erstellt werden (d. h. typischerweise /var/lib/flatpak/sideload-repos oder ~/.local/share/flatpak/sideload-repos). Zusätzlich können Symlinks in /run/flatpak/sideload-repos erstellt werden, was ein besserer Ort für nicht persistente Quellen ist (da dies beim Neustart gelöscht wird). Diese Symlinks können entweder auf das Verzeichnis verweisen, das an flatpak create-usb übergeben wird, das standardmäßig in den Unterpfad .ostree/repo schreibt, oder direkt auf ein OSTree-Repository.
OPTIONEN
Die folgenden globalen Optionen werden unterstützt. Einzelne Befehle haben eigene Optionen.
-h, --help
Hilfeoptionen anzeigen und beenden.
-v, --verbose
Debug-Informationen während der Befehlsausführung anzeigen. Verwenden Sie -vv für mehr Details.
--ostree-verbose
OSTree-Debug-Informationen während der Befehlsausführung anzeigen.
--version
Versionsinformationen ausgeben und beenden.
--default-arch
Die Standardarchitektur ausgeben und beenden.
--supported-arches
Die unterstützten Architekturen in Prioritätsreihenfolge ausgeben und beenden.
--gl-drivers
Die Liste der aktiven GL-Treiber ausgeben und beenden.
--installations
Pfade der Systeminstallationen ausgeben und beenden.
--print-system-only
Wenn der Befehl flatpak --print-updated-env ausgeführt wird, nur die Umgebungsvariablen für System-Flatpak-Installationen ausgeben, nicht die des Benutzer-Home-Verzeichnisses.
--print-updated-env
Die Menge der Umgebungsvariablen ausgeben, die zum Verwenden von Flatpaks erforderlich sind, und dabei die aktuelle Menge der Umgebungsvariablen ändern. Dies soll in einer Systemd-Umgebung verwendet werden und muss nicht manuell ausgeführt werden.
BEFEHLE
Befehle zum Verwalten installierter Anwendungen und Laufzeitumgebungen:
flatpak-install(1)
Eine Anwendung oder eine Laufzeitumgebung aus einem Remote-Repository oder einem Bundle installieren.
flatpak-update(1)
Eine installierte Anwendung oder Laufzeitumgebung aktualisieren.
flatpak-uninstall(1)
Eine installierte Anwendung oder Laufzeitumgebung deinstallieren.
flatpak-mask(1)
Updates und die automatische Installation verhindern.
flatpak-pin(1)
Laufzeitumgebungen festlegen, um die automatische Deinstallation zu verhindern.
flatpak-list(1)
Installierte Anwendungen und/oder Laufzeitumgebungen auflisten.
flatpak-info(1)
Informationen zu einer installierten Anwendung oder Laufzeitumgebung anzeigen.
flatpak-history(1)
Verlauf anzeigen.
flatpak-config(1)
Flatpak-Konfiguration verwalten.
flatpak-repair(1)
Flatpak-Installation reparieren.
flatpak-create-usb(1)
Apps und/oder Laufzeitumgebungen auf ein Wechselmedium kopieren.
Befehle zum Suchen von Anwendungen und Laufzeitumgebungen:
flatpak-search(1)
Nach Anwendungen und Laufzeitumgebungen suchen.
Befehle zum Verwalten von ausgeführten Anwendungen:
flatpak-run(1)
Eine Anwendung ausführen.
flatpak-kill(1)
Eine ausgeführte Anwendung beenden.
flatpak-override(1)
Berechtigungen für eine Anwendung außer Kraft setzen.
flatpak-make-current(1)
Die Standardversion zum Ausführen angeben.
flatpak-enter(1)
In den Namensraum einer ausgeführten Anwendung wechseln.
Befehle zum Verwalten des Dateizugriffs:
flatpak-document-export(1)
Einer Anwendung den Zugriff auf eine bestimmte Datei gewähren.
flatpak-document-unexport(1)
Den Zugriff auf eine bestimmte Datei widerrufen.
flatpak-document-info(1)
Informationen über eine bestimmte Datei anzeigen.
flatpak-documents(1)
Exportierte Dateien auflisten.
Befehle zum Verwalten des dynamischen Berechtigungs-Stores:
flatpak-permission-remove(1)
Element aus dem Berechtigungs-Store entfernen.
flatpak-permissions(1)
Berechtigungen auflisten.
flatpak-permission-show(1)
App-Berechtigungen anzeigen.
flatpak-permission-reset(1)
App-Berechtigungen zurücksetzen.
flatpak-permission-set(1)
App-Berechtigungen festlegen.
Befehle zum Verwalten von Remote-Repositories:
flatpak-remotes(1)
Alle konfigurierten Remote-Repositories auflisten.
flatpak-remote-add(1)
Ein neues Remote-Repository hinzufügen.
flatpak-remote-modify(1)
Eigenschaften eines konfigurierten Remote-Repositorys ändern.
flatpak-remote-delete(1)
Ein konfiguriertes Remote-Repository löschen.
flatpak-remote-ls(1)
Inhalte eines konfigurierten Remote-Repositorys auflisten.
flatpak-remote-info(1)
Informationen zu einem Ref in einem konfigurierten Remote-Repository anzeigen.
Befehle zum Erstellen von Anwendungen:
flatpak-build-init(1)
Ein Build-Verzeichnis initialisieren.
flatpak-build(1)
Einen Build-Befehl in einem Build-Verzeichnis ausführen.
flatpak-build-finish(1)
Ein Build-Verzeichnis zur Veröffentlichung vorbereiten.
flatpak-build-export(1)
Ein Build-Verzeichnis in ein Repository exportieren.
flatpak-build-bundle(1)
Eine Bundle-Datei aus einem Ref in einem lokalen Repository erstellen.
flatpak-build-import-bundle(1)
Eine Bundle-Datei in ein lokales Repository importieren.
flatpak-build-sign(1)
Eine Anwendung oder Laufzeitumgebung nach dem Export signieren.
flatpak-build-update-repo(1)
Die Summary-Datei in einem Repository aktualisieren.
flatpak-build-commit-from(1)
Ein neues Commit basierend auf einem vorhandenen Ref erstellen.
flatpak-repo(1)
Informationen zu einem Repository ausgeben.
Befehle, die innerhalb der Sandbox verfügbar sind:
flatpak-spawn(1)
Einen Befehl in einer anderen Sandbox ausführen.
DATEIFORMATE
Dateiformate, die von Flatpak-Befehlen verwendet werden:
flatpakref(5)
Referenz zu einem Remote-Repository für eine Anwendung oder Laufzeitumgebung.
flatpakrepo(5)
Referenz zu einem Remote-Repository.
flatpak-remote(5)
Konfiguration für ein Remote-Repository.
flatpak-installation(5)
Konfiguration für einen Installationsort.
flatpak-metadata(5)
Informationen zu einer Anwendung oder Laufzeitumgebung.
UMGEBUNG
Zusätzlich zu Standard-Umgebungsvariablen wie XDG_DATA_DIRS und XDG_DATA_HOME verwendet Flatpak einige eigene.
FLATPAK_BINARY
Pfad zur Flatpak-Executable, die in exportierte .desktop-Dateien und Skripte geschrieben wird, wenn eine App installiert wird. Standardmäßig ist dies /usr/bin/flatpak, sofern es nicht zur Build-Zeit durch --bindir überschrieben wird.
FLATPAK_BWRAP
Pfad zur bwrap(1)-Executable, die zum Erstellen der Sandbox verwendet wird. Abhängig davon, wie Flatpak zur Build-Zeit konfiguriert wurde, ist der Standard entweder die Suche im PATH oder die Verwendung einer mitgelieferten Kopie, die normalerweise als /usr/libexec/flatpak-bwrap installiert wird.
FLATPAK_CONFIG_DIR
Der Speicherort der Flatpak-Site-Konfiguration. Wenn dies nicht festgelegt ist, wird /etc/flatpak verwendet (es sei denn, es wird zur Build-Zeit durch --sysconfdir überschrieben).
FLATPAK_DATA_DIR
Der Speicherort der OS-weiten Standardeinstellungen und Integrations-Hooks von Flatpak. Wenn dies nicht festgelegt ist, wird /usr/share/flatpak verwendet, es sei denn, es wird zur Build-Zeit durch --datadir überschrieben.
FLATPAK_DBUSPROXY
Pfad zur xdg-dbus-proxy(1)-Executable, die zum Filtern des D-Bus-Datenverkehrs zwischen der Sandbox und dem Host-System verwendet wird. Abhängig davon, wie Flatpak zur Build-Zeit konfiguriert wurde, ist der Standard entweder die Suche im PATH oder die Verwendung einer mitgelieferten Kopie, die normalerweise als /usr/libexec/flatpak-dbus-proxy installiert wird.
FLATPAK_DOWNLOAD_TMPDIR
Pfad zu einem Verzeichnis, das vorübergehend beim Herunterladen von OCI-Layern und möglicherweise auch für andere Downloads in Zukunft verwendet wird. Für diesen Zweck wird nicht das Standard-TMPDIR verwendet, da Flatpak-Apps häufig zu groß sind, um in ein tmpfs zu passen.
FLATPAK_FANCY_OUTPUT
Kann auf 0 gesetzt werden, um die ansprechende Formatierung bei der Ausgabe in ein Terminal zu vermeiden. Diese Funktion wird auch automatisch deaktiviert, wenn die Standardausgabe kein Terminal ist oder wenn G_MESSAGES_DEBUG gesetzt ist.
FLATPAK_FORCE_TEXT_AUTH
Kann auf 1 gesetzt werden, um die Verwendung eines einfachen, integrierten Polkit(8)-Agents zu erzwingen, wenn eine Authentifizierung erforderlich ist, um die systemweite Installation zu ändern. Standardmäßig wird, falls verfügbar, der Polkit-Agent der Desktop-Umgebung verwendet, was normalerweise zu einer grafischen Eingabeaufforderung führt.
FLATPAK_GL_DRIVERS
Eine durch Doppelpunkte getrennte Liste von OpenGL-, Vulkan- und ähnlichen API-Grafiktreibererweiterungen, wobei die am meisten bevorzugten zuerst stehen. Standardmäßig wird ein Grafiktreiber automatisch ausgewählt. Die Werte in dieser Liste entsprechen dem letzten durch einen Punkt getrennten Teil der Namen von Erweiterungen mit der Bedingung active-gl-driver. Typische Werte sind default, mesa-git oder nvidia-550-120 (wobei die Versionsnummer durch die Haupt- und Nebenversion des Nvidia-Kernelmoduls ersetzt wird).
FLATPAK_RUN_DIR
Der Speicherort der globalen Flatpak-Runtime-Dateien. Wenn dies nicht gesetzt ist, wird /run/flatpak verwendet.
FLATPAK_SYSTEM_CACHE_DIR
Der Speicherort, an dem während des Abrufens in die systemweite Installation temporäre untergeordnete Repositories erstellt werden. Wenn dies nicht gesetzt ist, wird ein Verzeichnis in /var/tmp/ verwendet. Dies ist nützlich, da es wahrscheinlicher ist, dass es sich auf demselben Dateisystem wie das System-Repository befindet (wodurch die Wahrscheinlichkeit z. B. für die Reflink-Kopie erhöht wird), und wir können vermeiden, dass das Home-Verzeichnis des Benutzers mit temporären Daten gefüllt wird.
FLATPAK_SYSTEM_DIR
Der Speicherort der standardmäßigen systemweiten Installation. Wenn dies nicht gesetzt ist, wird /var/lib/flatpak verwendet (es sei denn, dies wird zur Build-Zeit durch --localstatedir oder -Dsystem_install_dir überschrieben).
FLATPAK_TTY_PROGRESS
Kann auf 1 gesetzt werden, um die Berichterstattung von maschinenlesbaren Fortschrittsinformationen an das Terminal zu aktivieren. Diese Funktion ist derzeit nicht standardmäßig aktiviert, da sie die OSC 9;4-Sequenz verwendet, die von einigen Terminalemulatoren als Popup-Benachrichtigung interpretiert wird.
FLATPAK_USER_DIR
Der Speicherort der pro Benutzer spezifischen Installation. Wenn dies nicht gesetzt ist, wird $XDG_DATA_HOME/flatpak verwendet.
SIEHE AUCH
ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org