1FIRECFG(1) firecfg man page FIRECFG(1)
2
6 Firecfg - Desktop integration utility for Firejail software.
7
9 firecfg [OPTIONS]
10
12 Firecfg is the desktop integration utility for Firejail sandbox. It
13 allows the user to sandbox applications automatically by clicking on
14 desktop manager icons and menus.
15 The integration covers:
17 - programs started in a terminal - typing "firefox" would be
19 enough to start a sandboxed Firefox browser
20 - programs started by clicking on desktop manager menus - all
22 major desktop managers are supported
23 - programs started by clicking on file icons in file manager -
25 only Cinnamon, KDE, LXDE/LXQT, MATE and XFCE desktop managers
26 are supported in this moment
27 To set it up, run "sudo firecfg" after installing Firejail software.
29 The same command should also be run after installing new programs. If
30 the program is supported by Firejail, the symbolic link in /usr/lo‐
31 cal/bin will be created. For a full list of programs supported by de‐
32 fault run "cat /etc/firejail/firecfg.config".
33 For user-driven manual integration, see DESKTOP INTEGRATION section in
35 man 1 firejail.
36
38 The following actions are implemented by default by running sudo
39 firecfg:
40 - set or update the symbolic links for desktop integration;
42 - add the current user to Firejail user access database (firecfg
44 --add-users);
45 - fix desktop files in $HOME/.local/share/applications/ (firecfg
47 --fix).
48
51 --add-users user [user]
52 Add the list of users to Firejail user access database.
53 Example:
55 $ sudo firecfg --add-users dustin lucas mike eleven
56 --bindir=directory
59 Create and search symbolic links in directory instead of the de‐
60 fault location /usr/local/bin. Directory should precede
61 /usr/bin and /bin in the PATH environment variable.
62 --clean
65 Remove all firejail symbolic links.
66 --fix Fix .desktop files. Some .desktop files use full path to exe‐
69 cutable. Firecfg will check .desktop files in /usr/share/appli‐
70 cations/, replace full path by name if it is in PATH, and write
71 result to $HOME/.local/share/applications/. This action is done
72 by default when running "sudo firecfg". We have it as a separate
73 option for regular users.
74 --fix-sound
77 Create a proper ~/.config/pulse/client.conf file without shm
78 support. On some PulseAudio versions, shared memory support
79 (shm) breaks the process ID namespace. PulseAudio software was
80 designed a long time ago, and the introduction of PID namespace
81 in Linux kernel breaks their design. This was reportedly fixed
82 in PulseAudio version 9. If you have sound problems on your sys‐
83 tem, run "firecfg --fix-sound" command in a terminal, followed
84 by logout/login in order to apply the changes.
85 --guide
87 Guided configuration for new users.
88 Example:
90 $ sudo firecfg --guide
91 --debug
93 Print debug messages.
94 -?, --help
96 Print options end exit.
97 --list List all firejail symbolic links
99 --version
101 Print program version and exit.
102 Example:
106 $ sudo firecfg
108 /usr/local/bin/firefox created
109 /usr/local/bin/vlc created
110 [...]
111 $ firecfg --list
112 /usr/local/bin/firefox
113 /usr/local/bin/vlc
114 [...]
115 $ sudo firecfg --clean
116 /usr/local/bin/firefox removed
117 /usr/local/bin/vlc removed
118 [...]
119
123 This program is free software; you can redistribute it and/or modify it
124 under the terms of the GNU General Public License as published by the
125 Free Software Foundation; either version 2 of the License, or (at your
126 option) any later version.
127 Homepage: https://firejail.wordpress.com
129
131 firejail(1), firemon(1), firejail-profile(5), firejail-login(5), fire‐
132 jail-users(5), jailcheck(1)
1330.9.72 Jul 2023 FIRECFG(1)