flatpak - Créer, installer et exécuter des applications et des environnements d'exécution
SYNTAXE
flatpak [OPTION...] {COMMANDE}
DESCRIPTION
Flatpak est un outil pour gérer les applications et les environnements d'exécution qu'elles utilisent. Dans le modèle Flatpak, les applications peuvent être créées et distribuées indépendamment du système hôte sur lequel elles sont utilisées, et elles sont isolées du système hôte (« en bac à sable ») dans une certaine mesure, au moment de l'exécution.
Flatpak peut fonctionner en mode système ou par utilisateur. Les données système (environnements d'exécution, applications et configuration) sont situées dans $prefix/var/lib/flatpak/, et les données par utilisateur sont dans $HOME/.local/share/flatpak/. En dessous de ces emplacements, il y a un dépôt local dans le sous-répertoire repo/ et les environnements d'exécution et les applications installés se trouvent dans les sous-répertoires runtime/ et app/ correspondants.
Les référentiels système peuvent être préconfigurés statiquement en déposant des fichiers flatpakrepo(5) dans /usr/share/flatpak/remotes.d/ et /etc/flatpak/remotes.d/. Si un fichier du même nom existe dans les deux, le fichier situé dans /etc aura la priorité.
En plus de l'installation système dans $prefix/var/lib/flatpak/, qui est toujours considérée comme l'installation par défaut, sauf si elle est remplacée, d'autres installations système peuvent être définies via des fichiers de configuration dans /etc/flatpak/installations.d/, qui doivent définir au moins l'ID de l'installation et le chemin absolu vers celle-ci. D'autres paramètres facultatifs tels que DisplayName, Priority ou StorageType sont également pris en charge.
Flatpak utilise OSTree pour distribuer et déployer des données. Les référentiels qu'il utilise sont des référentiels OSTree et peuvent être manipulés avec l'utilitaire ostree. Les environnements d'exécution et les applications installés sont des extractions OSTree.
Les commandes de base pour la création de paquets Flatpak, telles que build-init, build et build-finish, sont incluses dans l'utilitaire flatpak. Pour un support de création plus avancé, voir l'utilitaire distinct flatpak-builder(1).
Flatpak prend en charge l'installation à partir de référentiels secondaires. Il s'agit de copies partielles d'un référentiel (générées par flatpak create-usb) qui sont utilisées comme source d'installation lorsque l'on est hors ligne (et en ligne en tant qu'amélioration des performances). Ces référentiels sont configurés en créant des liens symboliques vers les sources secondaires dans le sous-répertoire sideload-repos du répertoire d'installation (c'est-à-dire généralement /var/lib/flatpak/sideload-repos ou ~/.local/share/flatpak/sideload-repos). De plus, des liens symboliques peuvent être créés dans /run/flatpak/sideload-repos, ce qui est un meilleur emplacement pour les sources non persistantes (car il est effacé au redémarrage). Ces liens symboliques peuvent pointer soit vers le répertoire spécifié à flatpak create-usb, qui écrit par défaut dans le sous-chemin .ostree/repo, soit directement vers un référentiel ostree.
OPTIONS
Les options globales suivantes sont prises en charge. Chaque commande dispose de ses propres options.
-h, --help
Affiche les options d’aide et quitte.
-v, --verbose
Affiche des informations de débogage pendant le traitement des commandes. Utilisez -vv pour plus de détails.
--ostree-verbose
Affiche les informations de débogage OSTree pendant le traitement des commandes.
--version
Affiche les informations de version et quitte.
--default-arch
Affiche l’architecture par défaut et quitte.
--supported-arches
Affiche les architectures prises en charge par ordre de priorité et quitte.
--gl-drivers
Affiche la liste des pilotes GL actifs et quitte.
--installations
Affiche les chemins d’accès aux installations du système et quitte.
--print-system-only
Lorsque la commande flatpak --print-updated-env est exécutée, affiche uniquement l’environnement pour les installations Flatpak système, et non les installations de l’utilisateur.
--print-updated-env
Affiche l’ensemble des variables d’environnement nécessaires pour utiliser les Flatpaks, en modifiant l’ensemble actuel des variables d’environnement. Cela est destiné à être utilisé dans un générateur d’environnement systemd, et ne doit pas être exécuté manuellement.
COMMANDES
Commandes pour gérer les applications et les environnements d’exécution installés :
flatpak-install(1)
Installe une application ou un environnement d’exécution à partir d’une source distante ou d’un paquet.
flatpak-update(1)
Met à jour une application ou un environnement d’exécution installé.
flatpak-uninstall(1)
Désinstalle une application ou un environnement d’exécution installé.
flatpak-mask(1)
Masque les mises à jour et l’installation automatique.
flatpak-pin(1)
Épingle les environnements d’exécution pour empêcher leur suppression automatique.
flatpak-list(1)
Affiche la liste des applications et/ou des environnements d’exécution installés.
flatpak-info(1)
Affiche des informations sur une application ou un environnement d’exécution installé.
flatpak-history(1)
Affiche l’historique.
flatpak-config(1)
Gère la configuration de Flatpak.
flatpak-repair(1)
Répare l’installation de Flatpak.
flatpak-create-usb(1)
Copie des applications et/ou des environnements d’exécution sur un support amovible.
Commandes pour rechercher des applications et des environnements d’exécution :
flatpak-search(1)
Recherche des applications et des environnements d’exécution.
Commandes pour gérer les applications en cours d’exécution :
flatpak-run(1)
Exécute une application.
flatpak-kill(1)
Arrête une application en cours d’exécution.
flatpak-override(1)
Remplace les autorisations d’une application.
flatpak-make-current(1)
Spécifie la version par défaut à exécuter.
flatpak-enter(1)
Entre dans l’espace de noms d’une application en cours d’exécution.
Commandes pour gérer l’accès aux fichiers :
flatpak-document-export(1)
Accorde à une application l’accès à un fichier spécifique.
flatpak-document-unexport(1)
Révoque l’accès à un fichier spécifique.
flatpak-document-info(1)
Affiche des informations sur un fichier spécifique.
flatpak-documents(1)
Affiche la liste des fichiers exportés.
Commandes pour gérer le magasin de permissions dynamique :
flatpak-permission-remove(1)
Supprime un élément du magasin de permissions.
flatpak-permissions(1)
Affiche la liste des permissions.
flatpak-permission-show(1)
Affiche les permissions d’une application.
flatpak-permission-reset(1)
Réinitialise les permissions d’une application.
flatpak-permission-set(1)
Définit les permissions d’une application.
Commandes pour gérer les dépôts distants :
flatpak-remotes(1)
Affiche la liste de tous les dépôts distants configurés.
flatpak-remote-add(1)
Ajoute un nouveau dépôt distant.
flatpak-remote-modify(1)
Modifie les propriétés d’un dépôt distant configuré.
flatpak-remote-delete(1)
Supprime un dépôt distant configuré.
flatpak-remote-ls(1)
Affiche le contenu d’un dépôt distant configuré.
flatpak-remote-info(1)
Affiche des informations sur une référence dans un dépôt distant configuré.
Commandes pour la construction d’applications :
flatpak-build-init(1)
Initialise un répertoire de construction.
flatpak-build(1)
Exécute une commande de construction dans un répertoire de construction.
flatpak-build-finish(1)
Finalise un répertoire de construction pour l’exportation.
flatpak-build-export(1)
Exporte un répertoire de construction vers un dépôt.
flatpak-build-bundle(1)
Crée un fichier bundle à partir d’une référence dans un dépôt local.
flatpak-build-import-bundle(1)
Importe un fichier bundle dans un dépôt local.
flatpak-build-sign(1)
Signe une application ou un environnement d’exécution après son exportation.
flatpak-build-update-repo(1)
Met à jour le fichier de résumé dans un dépôt.
flatpak-build-commit-from(1)
Crée un nouveau commit basé sur une référence existante.
flatpak-repo(1)
Affiche des informations sur un dépôt.
Commandes disponibles dans le sandbox :
flatpak-spawn(1)
Exécute une commande dans un autre sandbox.
FORMATS DE FICHIER
Formats de fichier utilisés par les commandes Flatpak :
flatpakref(5)
Référence vers un dépôt pour une application ou un environnement d’exécution.
flatpakrepo(5)
Référence vers un dépôt.
flatpak-remote(5)
Configuration d’un dépôt.
flatpak-installation(5)
Configuration d’un emplacement d’installation.
flatpak-metadata(5)
Informations sur une application ou un environnement d’exécution.
ENVIRONNEMENT
En plus des variables d’environnement standard telles que XDG_DATA_DIRS et XDG_DATA_HOME, Flatpak consulte également certaines de ses propres variables.
FLATPAK_BINARY
Chemin d’accès à l’exécutable flatpak qui sera écrit dans les fichiers .desktop et les scripts exportés
lorsqu’une application est installée. La valeur par défaut est /usr/bin/flatpak, sauf si elle est remplacée lors de la construction par
--bindir.
FLATPAK_BWRAP
Chemin d’accès à l’exécutable bwrap(1) qui sera utilisé pour créer le sandbox. En fonction de la manière dont
Flatpak a été configuré lors de la construction, la valeur par défaut est soit de rechercher dans PATH, soit d’utiliser une copie fournie qui est normalement installée sous /usr/libexec/flatpak-bwrap.
FLATPAK_CONFIG_DIR
L’emplacement de la configuration du site Flatpak. Si cette variable n’est pas définie, /etc/flatpak est utilisé (sauf si elle est
remplacée lors de la construction par --sysconfdir).
FLATPAK_DATA_DIR
L’emplacement des valeurs par défaut et des hooks d’intégration de Flatpak au niveau du système d’exploitation. Si cette variable n’est pas définie,
/usr/share/flatpak est utilisé, sauf si elle est remplacée lors de la construction par --datadir.
FLATPAK_DBUSPROXY
Chemin d’accès à l’exécutable xdg-dbus-proxy(1) qui sera utilisé pour filtrer le trafic D-Bus entre
le sandbox et le système hôte. En fonction de la manière dont Flatpak a été configuré lors de la construction, la
valeur par défaut est soit de rechercher dans PATH, soit d’utiliser une copie fournie qui est normalement installée sous
/usr/libexec/flatpak-dbus-proxy.
FLATPAK_DOWNLOAD_TMPDIR
Chemin d’accès à un répertoire qui sera utilisé temporairement lors du téléchargement des couches OCI, et
potentiellement pour d’autres téléchargements à l’avenir. Le répertoire TMPDIR standard n’est pas utilisé à cet effet, car
les applications Flatpak sont souvent trop volumineuses pour tenir dans un tmpfs.
FLATPAK_FANCY_OUTPUT
Peut être défini sur 0 pour éviter un formatage élaboré lors de l'affichage dans un terminal. Cette fonctionnalité est également
désactivée automatiquement lorsque la sortie standard n'est pas un terminal, ou lorsque G_MESSAGES_DEBUG est
définie.
FLATPAK_FORCE_TEXT_AUTH
Peut être défini sur 1 pour forcer l'utilisation d'un agent polkit(8) intégré simple lorsque l'authentification est
requise pour modifier l'installation à l'échelle du système. Par défaut, l'agent polkit de l'environnement de bureau est utilisé, le cas échéant, ce qui entraîne généralement une invite graphique.
FLATPAK_GL_DRIVERS
Une liste de pilotes graphiques pour OpenGL, Vulkan et des API similaires, séparée par des deux-points, à essayer, en commençant par le plus préféré. Par défaut, le pilote graphique est sélectionné automatiquement.
Les valeurs de cette liste correspondent à la dernière composante séparée par un point des noms des extensions avec
la condition active-gl-driver. Les valeurs typiques sont default, mesa-git ou nvidia-550-120
(en remplaçant le numéro de version par la version principale et secondaire du module du noyau nvidia).
FLATPAK_RUN_DIR
L'emplacement des fichiers globaux de l'environnement d'exécution Flatpak. Si cette variable n'est pas définie, /run/flatpak est utilisé.
FLATPAK_SYSTEM_CACHE_DIR
L'emplacement où les dépôts enfants temporaires seront créés lors des extractions vers l'installation à l'échelle du système. Si cette variable n'est pas définie, un répertoire dans /var/tmp/ est utilisé. Ceci est
utile car il est plus probable qu'il se trouve sur le même système de fichiers que le dépôt système (augmentant ainsi les chances de, par exemple, la copie reflink), et nous pouvons éviter de remplir le répertoire personnel de l'utilisateur avec des données temporaires.
FLATPAK_SYSTEM_DIR
L'emplacement de l'installation système par défaut. Si cette variable n'est pas définie, /var/lib/flatpak est
utilisé (à moins qu'elle ne soit remplacée au moment de la construction par --localstatedir ou -Dsystem_install_dir).
FLATPAK_TTY_PROGRESS
Peut être défini sur 1 pour activer la transmission d'informations de progression lisibles par machine au terminal. Cette fonctionnalité n'est pas activée par défaut car elle utilise la séquence OSC 9;4, que certains émulateurs de terminal interprètent comme une notification contextuelle.
FLATPAK_USER_DIR
L'emplacement de l'installation par utilisateur. Si cette variable n'est pas définie, $XDG_DATA_HOME/flatpak est
utilisé.
VOIR AUSSI
ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org