1FIRECFG(1)                     firecfg man page                     FIRECFG(1)
2
3
4

NAME

6       Firecfg - Desktop integration utility for Firejail software.
7

SYNOPSIS

9       firecfg [OPTIONS]
10

DESCRIPTION

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
16       The integration covers:
17
18              -  programs  started  in  a terminal - typing "firefox" would be
19              enough to start a sandboxed Firefox browser
20
21              - programs started by clicking on desktop manager  menus  -  all
22              major desktop managers are supported
23
24              -  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
28       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
34       For  user-driven manual integration, see DESKTOP INTEGRATION section in
35       man 1 firejail.
36

DEFAULT ACTIONS

38       The following actions  are  implemented  by  default  by  running  sudo
39       firecfg:
40
41              - set or update the symbolic links for desktop integration;
42
43              - add the current user to Firejail user access database (firecfg
44              --add-users);
45
46              - fix desktop files in $HOME/.local/share/applications/ (firecfg
47              --fix).
48
49

OPTIONS

51       --add-users user [user]
52              Add the list of users to Firejail user access database.
53
54              Example:
55              $ sudo firecfg --add-users dustin lucas mike eleven
56
57
58       --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
63
64       --clean
65              Remove all firejail symbolic links.
66
67
68       --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
75
76       --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
86       --debug
87              Print debug messages.
88
89       -?, --help
90              Print options end exit.
91
92       --list List all firejail symbolic links
93
94       --version
95              Print program version and exit.
96
97
98
99       Example:
100
101       $ 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
114
115

LICENSE

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
122       Homepage: https://firejail.wordpress.com
123

SEE ALSO

125       firejail(1), firemon(1), firejail-profile(5),  firejail-login(5)  fire‐
126       jail-users(5)
127
128
129
1300.9.64                             Oct 2020                         FIRECFG(1)
Impressum