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
31 /usr/local/bin will be created. For a full list of programs supported
32 by default run "cat /usr/lib/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
60 default location /user/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 --debug
87 Print debug messages.
88 -?, --help
90 Print options end exit.
91 --list List all firejail symbolic links
93 --version
95 Print program version and exit.
96 Example:
100 $ sudo firecfg
102 /usr/local/bin/firefox created
103 /usr/local/bin/vlc created
104 [...]
105 $ firecfg --list
106 /usr/local/bin/firefox
107 /usr/local/bin/vlc
108 [...]
109 $ sudo firecfg --clean
110 /usr/local/bin/firefox removed
111 /usr/local/bin/vlc removed
112 [...]
113
117 This program is free software; you can redistribute it and/or modify it
118 under the terms of the GNU General Public License as published by the
119 Free Software Foundation; either version 2 of the License, or (at your
120 option) any later version.
121 Homepage: https://firejail.wordpress.com
123
125 firejail(1), firemon(1), firejail-profile(5), firejail-login(5) fire‐
126 jail-users(5)
1270.9.64 Oct 2020 FIRECFG(1)