FLATPAK RUN(1) flatpak run FLATPAK RUN(1) (NAME) flatpak-run - (runtime) (SYNOPSIS) flatpak run [OPTION...] REF [ARG...] (DESCRIPTION) REF () . . --branch --arch . flatpak-make-current(1). REF (runtime) . . . --branch . --arch . (per-user) . --user --system --installation . (mount) /usr /var ( ) . /app . --share --socket run : . . --file-forwarding . --clear-env . --env . : PATH LD_LIBRARY_PATH LD_PRELOAD LD_AUDIT XDG_CONFIG_DIRS XDG_DATA_DIRS SHELL TEMP TEMPDIR TMP TMPDIR XDG_RUNTIME_DIR container TZDIR PYTHONPATH PYTHONPYCACHEPREFIX PERLLIB PERL5LIB XCURSOR_PATH GST_PLUGIN_PATH_1_0 GST_REGISTRY GST_REGISTRY_1_0 GST_PLUGIN_PATH GST_PLUGIN_SYSTEM_PATH GST_PLUGIN_SCANNER GST_PLUGIN_SCANNER_1_0 GST_PLUGIN_SYSTEM_PATH_1_0 GST_PRESET_PATH GST_PTP_HELPER GST_PTP_HELPER_1_0 GST_INSTALL_PLUGINS_HELPER KRB5CCNAME XKB_CONFIG_ROOT GIO_EXTRA_MODULES GDK_BACKEND VK_ADD_DRIVER_FILES VK_ADD_LAYER_PATH VK_DRIVER_FILES VK_ICD_FILENAMES VK_LAYER_PATH __EGL_EXTERNAL_PLATFORM_CONFIG_DIRS __EGL_EXTERNAL_PLATFORM_CONFIG_FILENAMES __EGL_VENDOR_LIBRARY_DIRS __EGL_VENDOR_LIBRARY_FILENAMES "GST_" gstreamer ( 1.12.5 ). XDG ~/.var/app/$APPID/: : XDG_DATA_HOME XDG_CONFIG_HOME XDG_CACHE_HOME XDG_STATE_HOME (since Flatpak 1.13) --persist=.local/state --unset-env=XDG_STATE_HOME ~/.local/state 1.13 . HOST_- : HOST_XDG_DATA_HOME HOST_XDG_CONFIG_HOME HOST_XDG_CACHE_HOME HOST_XDG_STATE_HOME (since Flatpak 1.13) FLATPAK_ID . /etc/os-release ( /usr/lib/os-release ) os-release[1] /run/host/os-release (bind-mount) . . (OPTIONS) : -h, --help . -u, --user (per-user). --system . --installation=NAME NAME /etc/flatpak/installations.d/. --installation=default --system . -v, --verbose . --ostree-verbose OSTree . --arch=ARCH . flatpak --supported-arches . --command=COMMAND . --cwd=DIR . . --branch=BRANCH . -d, --devel (devel) seccomp . --runtime=RUNTIME . org.freedesktop.Sdk/x86_64/1.2 . . --runtime-version=VERSION . --runtime . --share=SUBSYSTEM . Context . SUBSYSTEM : network ipc. . --unshare=SUBSYSTEM . Context . SUBSYSTEM : network ipc. . --share-if=SUBSYSTEM:CONDITION . Context . SUBSYSTEM network ipc . CONDITION : true, false, has-input-device, has-wayland, has-usb-device, has-usb-portal. ! !has-input-device. . 1.17 . (Conditional Permissions) flatpak-metadata(5) . --socket=SOCKET . Context . SOCKET : x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus, ssh-auth, pcsc, cups, gpg-agent, inherit-wayland-socket. . --nosocket=SOCKET . Context . SOCKET : x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus, ssh-auth, pcsc, cups, gpg-agent, inherit-wayland-socket. . --socket-if=SOCKET:CONDITION . Context . SOCKET : x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus, ssh-auth, pcsc, cups, gpg-agent, inherit-wayland-socket. CONDITION : true, false, has-input-device, has-wayland, has-usb-device, has-usb-portal. ! !has-wayland. . 1.17 . (Conditional Permissions) flatpak-metadata(5) . --device=DEVICE . Context . DEVICE : dri, input, usb, kvm, shm, all. . --nodevice=DEVICE . Context . DEVICE : dri, input, usb, kvm, shm, all. . --device-if=DEVICE:CONDITION . Context . DEVICE : dri, input, usb, kvm, shm, all. CONDITION : true, false, has-input-device, has-wayland, has-usb-device, has-usb-portal. ! !has-input-device. . 1.17 . (Conditional Permissions) flatpak-metadata(5) . --allow=FEATURE . Context . FEATURE devel multiarch bluetooth . . flatpak-build- finish(1) . --disallow=FEATURE . Context . FEATURE devel multiarch bluetooth . . --allow-if=FEATURE:CONDITION . Context . FEATURE devel multiarch bluetooth . CONDITION : true, false, has-input-device, has-wayland, has-usb-device, has-usb-portal. ! !has-input-device. . 1.17 . (Conditional Permissions) flatpak-metadata(5) . --filesystem=FILESYSTEM . Context . FILESYSTEM : home, host, host-os, host-etc, host-root, xdg-desktop, xdg-documents, xdg-download, xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run, xdg-config, xdg-cache, xdg-data ~/dir xdg xdg-download/subdir. :ro . :create / . . "[Context] filesystems" flatpak-metadata(5) . --nofilesystem=FILESYSTEM --filesystem=FILESYSTEM / flatpak- override(1). Context . FILESYSTEM --filesystem :ro :create . . --filesystem . --filesystem=xdg-config/MyApp flatpak override --user --nofilesystem=home $XDG_CONFIG_HOME/MyApp . --nofilesystem=host:reset --nofilesystem=host --filesystem flatpak-override(1) . --add-policy=SUBSYSTEM.KEY=VALUE (generic policy). "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" : [Policy subsystem] key=v1;v2; . --remove-policy=SUBSYSTEM.KEY=VALUE . . --usb=TYPE[:DATA] USB . USB . TYPE all cls dev vnd . all . cls . DATA CLASS:SUBCLASS CLASS SUBCLASS . SUBCLASS * . dev (product id) . DATA 0a1b. vnd . vnd (vendor id) . DATA 0fab. + --usb=vnd:0123+dev:4567. dev vnd . 1.15.11 . --nousb=VENDOR_ID:PRODUCT_ID USB . . --usb . 1.15.11 . --env=VAR=VALUE . Context . . --unset-env=VAR . unset-environment [Context] [Environment] . . --env-fd=FD FD --env. . VAR=VALUE . env -0 /proc/*/environ . --clear-env (). . --own-name=NAME () NAME (session bus). NAME .* . Context . . --talk-name=NAME NAME (session bus). NAME .* . Context . . --no-talk-name=NAME NAME (session bus). NAME .* . Context . . --system-own-name=NAME () NAME (system bus). NAME .* . Context . . --system-talk-name=NAME NAME (system bus). NAME .* . Context . . --system-no-talk-name=NAME NAME (system bus). NAME .* . Context . . --a11y-own-name=NAME () NAME (a11y bus). NAME .* . Context . . --persist=FILENAME ( ) FILENAME (bind mount) . Context . . --no-session-bus dbus . --sandbox . --session-bus dbus . --sandbox . () (org.the.App.*) ( ) .Sandboxed ( org.the.App.Sandboxed.* org.mpris.MediaPlayer2.org.the.App.Sandboxed.*) . --no-a11y-bus (accessibility bus). --sandbox . --a11y-bus . --sandbox . --sandbox () // . --log-session-bus . D-Bus . --log-system-bus . D-Bus . -p, --die-with-parent . --parent-pid=PID (PID) <<>> --parent-expose-pids --parent-share-pids . --parent-expose-pids ( --parent-pid ) . --parent-share-pids --parent-pid . --parent-expose-pids . --instance-id-fd (instance ID) . --file-forwarding '@@' . "@@u" "@@" URI URI "file:" . () . --app-path=PATH /app PATH /app /run/parent/app . /run/parent/app LD_LIBRARY_PATH . --app-path= --app-path= ( PATH ) /app . --usr-path=PATH /usr PATH /usr /run/parent/usr . /run/parent/usr LD_LIBRARY_PATH . --app-path= --env=LD_LIBRARY_PATH=... . (EXAMPLES) $ flatpak run org.gnome.gedit $ flatpak run --devel --command=bash org.gnome.Builder $ flatpak run --command=bash org.gnome.Sdk $ flatpak run org.gnome.Boxes --nousb=0fd9:* (SEE ALSO) flatpak(1), flatpak-override(1), flatpak-enter(1) (NOTES) 1. os-release https://www.freedesktop.org/software/systemd/man/os-release.html flatpak FLATPAK RUN(1)