1FLATPAK SPAWN(1) flatpak spawn FLATPAK SPAWN(1)
2
3
4
6 flatpak-spawn - Run commands in a sandbox
7
9 flatpak-spawn [OPTION...] COMMAND [ARGUMENT...]
10
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 When called without --host, flatpak-spawn uses the Flatpak portal to
17 create a copy of the sandbox it was called from, optionally using
18 tighter permissions and optionally the latest version of the app and
19 runtime (see --latest-version).
20
22 The following options are understood:
23
24 -h, --help
25 Show help options and exit.
26
27 -v, --verbose
28 Print debug information
29
30 --forward-fd=FD
31 Forward a file descriptor
32
33 --clear-env
34 Run with a clean environment
35
36 --watch-bus
37 Make the spawned command exit if the caller disappears from the
38 session bus
39
40 --env=VAR=VALUE
41 Set an environment variable
42
43 --latest-version
44 Use the latest version of the refs that are used to set up the
45 sandbox
46
47 --no-network
48 Run without network access
49
50 --sandbox
51 Run fully sandboxed. See the documentation for the --sandbox option
52 in flatpak-run(1)
53
54 See the --sandbox-expose and --sandbox-expose-ro options for
55 selective file access.
56
57 --sandbox-expose=NAME
58 Expose read-write access to a file in the sandbox.
59
60 Note that absolute paths or subdirectories are not allowed. The
61 files must be in the sandbox subdirectory of the instance directory
62 (i.e. ~/.var/app/$APP_ID/sandbox).
63
64 This option is useful in combination with --sandbox (otherwise the
65 instance directory is accessible anyway).
66
67 --sandbox-expose-ro=NAME
68 Expose readonly access to a file in the sandbox.
69
70 Note that absolute paths or subdirectories are not allowed. The
71 files must be in the sandbox subdirectory of the instance directory
72 (i.e. ~/.var/app/$APP_ID/sandbox).
73
74 This option is useful in combination with --sandbox (otherwise the
75 instance directory is accessible anyway).
76
77 --host
78 Run the command unsandboxed on the host. This requires access to
79 the org.freedesktop.Flatpak D-Bus interface.
80
81 --directory=DIR
82 The working directory in which to run the command.
83
84 Note that the given directory must exist in the sandbox or, when
85 used in conjunction with --host, on the host.
86
88 $ flatpak-spawn ls /var/run
89
91 flatpak(1)
92
93
94
95flatpak FLATPAK SPAWN(1)