1FLATPAK SPAWN(1)                 flatpak spawn                FLATPAK SPAWN(1)
2
3
4

NAME

6       flatpak-spawn - Run commands in a sandbox
7

SYNOPSIS

9       flatpak-spawn [OPTION...] COMMAND [ARGUMENT...]
10

DESCRIPTION

12       Unlike other flatpak commands, flatpak-spawn is available to
13       applications inside the sandbox. It runs COMMAND outside the sandbox,
14       either in another sandbox, or on the host.
15
16       flatpak-spawn uses the Flatpak portal to create a copy the sandbox it
17       was called from, optionally using tighter permissions and the latest
18       version of the app and runtime.
19

OPTIONS

21       The following options are understood:
22
23       -h, --help
24           Show help options and exit.
25
26       -v, --verbose
27           Print debug information
28
29       --forward-fd=FD
30           Forward a file descriptor
31
32       --clear-env
33           Run with a clean environment
34
35       --env=VAR=VALUE
36           Set an environment variable
37
38       --latest-version
39           Use the latest version of the refs that are used to set up the
40           sandbox
41
42       --no-network
43           Run without network access
44
45       --sandbox
46           Run fully sandboxed.
47
48           See the --sandbox-expose and --sandbox-expose-ro options for
49           selective file access.
50
51       --sandbox-expose=NAME
52           Expose read-write access to a file in the sandbox.
53
54           Note that absolute paths or subdirectories are not allowed. The
55           files must be in the sandbox subdirectory of the instance directory
56           (i.e.  ~/.var/app/$APP_ID/sandbox).
57
58           This option is useful in combination with --sandbox (otherwise the
59           instance directory is accessible anyway).
60
61       --sandbox-expose-ro=NAME
62           Expose readonly access to a file in the sandbox.
63
64           Note that absolute paths or subdirectories are not allowed. The
65           files must be in the sandbox subdirectory of the instance directory
66           (i.e.  ~/.var/app/$APP_ID/sandbox).
67
68           This option is useful in combination with --sandbox (otherwise the
69           instance directory is accessible anyway).
70
71       --host
72           Run the command unsandboxed on the host. This requires access to
73           the org.freedesktop.Flatpak D-Bus interface
74

EXAMPLES

76       $ flatpak-spawn ls /var/run
77

SEE ALSO

79       flatpak(1)
80
81
82
83flatpak                                                       FLATPAK SPAWN(1)