flatpak: construir, instalar y ejecutar aplicaciones y entornos de ejecución
SINOPSIS
flatpak [OPCIÓN...] {COMANDO}
DESCRIPCIÓN
Flatpak es una herramienta para administrar aplicaciones y los entornos de ejecución que utilizan. En el modelo Flatpak, las aplicaciones se pueden construir y distribuir de forma independiente del sistema host en el que se utilizan, y están aisladas del sistema host ('en un entorno aislado') hasta cierto punto, en tiempo de ejecución.
Flatpak puede operar en modo a nivel del sistema o por usuario. Los datos a nivel del sistema (entornos de ejecución, aplicaciones y configuración) se encuentran en $prefix/var/lib/flatpak/ y los datos por usuario en $HOME/.local/share/flatpak/. Debajo de estas ubicaciones, hay un repositorio local en el subdirectorio repo/ y los entornos de ejecución y las aplicaciones instaladas están en los subdirectorios runtime/ y app/ correspondientes.
Los repositorios remotos a nivel del sistema se pueden preconfigurar estáticamente colocando archivos flatpakrepo(5) en /usr/share/flatpak/remotes.d/ y /etc/flatpak/remotes.d/. Si existe un archivo con el mismo nombre en ambas ubicaciones, el archivo de /etc tendrá prioridad.
Además de la instalación a nivel del sistema en $prefix/var/lib/flatpak/, que siempre se considera la predeterminada a menos que se cambie, se pueden definir más instalaciones a nivel del sistema a través de archivos de configuración en /etc/flatpak/installations.d/, que deben definir al menos el id. de la instalación y la ruta absoluta a ella. También se admiten otros parámetros opcionales como DisplayName, Priority o StorageType.
Flatpak utiliza OSTree para distribuir e implementar datos. Los repositorios que utiliza son repositorios OSTree y se pueden manipular con la utilidad ostree. Los entornos de ejecución y las aplicaciones instaladas son instantáneas de OSTree.
Se incluyen comandos básicos para construir flatpaks, como build-init, build y build-finish, en la utilidad flatpak. Para un soporte de construcción de nivel superior, consulte la herramienta flatpak-builder(1) separada.
Flatpak admite la instalación desde repositorios secundarios. Estos son copias parciales de un repositorio (generadas por flatpak create-usb) que se utilizan como fuente de instalación cuando se está sin conexión (y en línea como una mejora del rendimiento). Estos repositorios se configuran creando enlaces simbólicos a las fuentes secundarias en el subdirectorio sideload-repos del directorio de instalación (es decir, normalmente /var/lib/flatpak/sideload-repos o ~/.local/share/flatpak/sideload-repos). Además, se pueden crear enlaces simbólicos en /run/flatpak/sideload-repos, que es una ubicación mejor para las fuentes no persistentes (ya que se borra al reiniciar). Estos enlaces simbólicos pueden apuntar ya sea al directorio que se proporciona a flatpak create-usb, que por defecto escribe en la subruta .ostree/repo, o directamente a un repositorio ostree.
OPCIONES
Las siguientes opciones globales son comprendidas. Los comandos individuales tienen sus propias opciones.
-h, --help
Muestra las opciones de ayuda y sale.
-v, --verbose
Muestra información de depuración durante el procesamiento de comandos. Use -vv para obtener más detalles.
--ostree-verbose
Muestra información de depuración de OSTree durante el procesamiento de comandos.
--version
Imprime información de la versión y sale.
--default-arch
Imprime la arquitectura predeterminada y sale.
--supported-arches
Imprime las arquitecturas compatibles en orden de prioridad y sale.
--gl-drivers
Imprime la lista de controladores gl activos y sale.
--installations
Imprime las rutas de las instalaciones del sistema y sale.
--print-system-only
Cuando se ejecuta el comando flatpak --print-updated-env, imprime solo el entorno para las instalaciones de flatpak del sistema, sin incluir la instalación del directorio de inicio del usuario.
--print-updated-env
Imprime el conjunto de variables de entorno necesarias para usar flatpaks, modificando el conjunto actual de variables de entorno. Está diseñado para usarse en un generador de entornos systemd y no debe ejecutarse manualmente.
COMANDOS
Comandos para administrar aplicaciones y entornos instalados:
flatpak-install(1)
Instala una aplicación o un entorno desde un repositorio remoto o un paquete.
flatpak-update(1)
Actualiza una aplicación o un entorno instalado.
flatpak-uninstall(1)
Desinstala una aplicación o un entorno instalado.
flatpak-mask(1)
Impide las actualizaciones y la instalación automática.
flatpak-pin(1)
Fija los entornos para evitar la eliminación automática.
flatpak-list(1)
Lista las aplicaciones y/o entornos instalados.
flatpak-info(1)
Muestra información de una aplicación o un entorno instalado.
flatpak-history(1)
Muestra el historial.
flatpak-config(1)
Administra la configuración de flatpak.
flatpak-repair(1)
Repara la instalación de flatpak.
flatpak-create-usb(1)
Copia aplicaciones y/o entornos a medios extraíbles.
Comandos para encontrar aplicaciones y entornos:
flatpak-search(1)
Busca aplicaciones y entornos.
Comandos para administrar las aplicaciones en ejecución:
flatpak-run(1)
Ejecuta una aplicación.
flatpak-kill(1)
Detiene una aplicación en ejecución.
flatpak-override(1)
Anula los permisos de una aplicación.
flatpak-make-current(1)
Especifica la versión predeterminada que se va a ejecutar.
flatpak-enter(1)
Entra en el espacio de nombres de una aplicación en ejecución.
Comandos para administrar el acceso a archivos:
flatpak-document-export(1)
Otorga a una aplicación acceso a un archivo específico.
flatpak-document-unexport(1)
Revoca el acceso a un archivo específico.
flatpak-document-info(1)
Muestra información sobre un archivo específico.
flatpak-documents(1)
Lista los archivos exportados.
Comandos para administrar el almacén de permisos dinámicos:
flatpak-permission-remove(1)
Elimina un elemento del almacén de permisos.
flatpak-permissions(1)
Lista los permisos.
flatpak-permission-show(1)
Muestra los permisos de la aplicación.
flatpak-permission-reset(1)
Restablece los permisos de la aplicación.
flatpak-permission-set(1)
Establece los permisos de la aplicación.
Comandos para administrar los repositorios remotos:
flatpak-remotes(1)
Lista todos los repositorios remotos configurados.
flatpak-remote-add(1)
Añade un nuevo repositorio remoto.
flatpak-remote-modify(1)
Modifica las propiedades de un repositorio remoto configurado.
flatpak-remote-delete(1)
Elimina un repositorio remoto configurado.
flatpak-remote-ls(1)
Lista el contenido de un repositorio remoto configurado.
flatpak-remote-info(1)
Muestra información sobre una referencia en un repositorio remoto configurado.
Comandos para construir aplicaciones:
flatpak-build-init(1)
Inicializa un directorio de construcción.
flatpak-build(1)
Ejecuta un comando de construcción en un directorio de construcción.
flatpak-build-finish(1)
Finaliza un directorio de construcción para su exportación.
flatpak-build-export(1)
Exporta un directorio de construcción a un repositorio.
flatpak-build-bundle(1)
Crea un archivo de paquete a partir de una referencia en un repositorio local.
flatpak-build-import-bundle(1)
Importa un archivo de paquete en un repositorio local.
flatpak-build-sign(1)
Firma una aplicación o entorno de ejecución después de que se haya exportado.
flatpak-build-update-repo(1)
Actualiza el archivo de resumen en un repositorio.
flatpak-build-commit-from(1)
Crea un nuevo commit basado en una referencia existente.
flatpak-repo(1)
Imprime información sobre un repositorio.
Comandos disponibles dentro del sandbox:
flatpak-spawn(1)
Ejecuta un comando en otro sandbox.
FORMATOS DE ARCHIVO
Formatos de archivo que se utilizan con los comandos de Flatpak:
flatpakref(5)
Referencia a un repositorio remoto para una aplicación o entorno de ejecución.
flatpakrepo(5)
Referencia a un repositorio remoto.
flatpak-remote(5)
Configuración para un repositorio remoto.
flatpak-installation(5)
Configuración para una ubicación de instalación.
flatpak-metadata(5)
Información sobre una aplicación o entorno de ejecución.
ENTORNO
Además de las variables de entorno estándar, como XDG_DATA_DIRS y XDG_DATA_HOME, Flatpak consulta algunas de sus propias variables.
FLATPAK_BINARY
Ruta al ejecutable de flatpak que se escribirá en los archivos .desktop y scripts exportados cuando se instale una aplicación. El valor predeterminado es /usr/bin/flatpak, a menos que se anule en el momento de la compilación mediante --bindir.
FLATPAK_BWRAP
Ruta al ejecutable bwrap(1) que se utilizará para crear el sandbox. Dependiendo de cómo se configuró Flatpak en el momento de la compilación, el valor predeterminado es buscar en PATH, o utilizar una copia suministrada que normalmente se instala como /usr/libexec/flatpak-bwrap.
FLATPAK_CONFIG_DIR
La ubicación de la configuración del sitio de flatpak. Si no está configurada, se utiliza /etc/flatpak (a menos que se anule en el momento de la compilación mediante --sysconfdir).
FLATPAK_DATA_DIR
La ubicación de los valores predeterminados a nivel del sistema operativo de Flatpak y los hooks de integración. Si no está configurada, se utiliza /usr/share/flatpak, a menos que se anule en el momento de la compilación mediante --datadir.
FLATPAK_DBUSPROXY
Ruta al ejecutable xdg-dbus-proxy(1) que se utilizará para filtrar el tráfico de D-Bus entre el sandbox y el sistema host. Dependiendo de cómo se configuró Flatpak en el momento de la compilación, el valor predeterminado es buscar en PATH, o utilizar una copia suministrada que normalmente se instala como /usr/libexec/flatpak-dbus-proxy.
FLATPAK_DOWNLOAD_TMPDIR
Ruta a un directorio que se utilizará temporalmente al descargar capas OCI, y potencialmente para otras descargas en el futuro. El directorio TMPDIR estándar no se utiliza para esto, porque las aplicaciones de Flatpak suelen ser demasiado grandes para caber en un tmpfs.
FLATPAK_FANCY_OUTPUT
Se puede establecer en 0 para evitar el formato sofisticado al imprimir en una terminal. Esta función también
se desactiva automáticamente cuando la salida estándar no es una terminal o cuando G_MESSAGES_DEBUG
está establecido.
FLATPAK_FORCE_TEXT_AUTH
Se puede establecer en 1 para forzar el uso de un agente polkit(8) integrado simple cuando se requiere
autenticación para modificar la instalación a nivel de sistema. De forma predeterminada, se utiliza el
agente polkit del entorno de escritorio, si está disponible, lo que normalmente da como resultado una
solicitud gráfica.
FLATPAK_GL_DRIVERS
Una lista separada por dos puntos de extensiones de controladores gráficos para intentar usar para OpenGL,
Vulkan y API similares, la más preferida primero. El valor predeterminado es seleccionar un
controlador de gráficos automáticamente. Los valores de esta lista coinciden con el último componente
separado por puntos de los nombres de las extensiones con la condición active-gl-driver. Los valores
típicos son default, mesa-git o nvidia-550-120 (reemplazando el número de versión por la versión
principal y secundaria del módulo del kernel de nvidia).
FLATPAK_RUN_DIR
La ubicación de los archivos globales de tiempo de ejecución de Flatpak. Si no se establece, se utiliza
/run/flatpak.
FLATPAK_SYSTEM_CACHE_DIR
La ubicación donde se crearán los repositorios temporales de nivel secundario durante las operaciones
de extracción en la instalación a nivel de sistema. Si no se establece, se utiliza un directorio en
/var/tmp/. Esto es útil porque es más probable que esté en el mismo sistema de archivos que el
repositorio del sistema (aumentando así las posibilidades de, por ejemplo, la copia de reflinks) y
podemos evitar llenar el directorio de inicio del usuario con datos temporales.
FLATPAK_SYSTEM_DIR
La ubicación de la instalación predeterminada a nivel de sistema. Si no se establece, se utiliza
/var/lib/flatpak (a menos que se anule en tiempo de compilación mediante --localstatedir o
-Dsystem_install_dir).
FLATPAK_TTY_PROGRESS
Se puede establecer en 1 para habilitar la generación de informes de progreso legibles por máquina en la
terminal. Esta función no está habilitada de forma predeterminada porque utiliza la secuencia OSC 9;4,
que algunos emuladores de terminal interpretan como una notificación emergente.
FLATPAK_USER_DIR
La ubicación de la instalación por usuario. Si no se establece, se utiliza $XDG_DATA_HOME/flatpak.
VÉASE TAMBIÉN
ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org