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 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
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 diretory 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 diretory 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
76 $ flatpak-spawn ls /var/run
77
79 flatpak(1)
80
81
82
83flatpak FLATPAK SPAWN(1)