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 /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
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 de‐
60              fault  location  /usr/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       --guide
87              Guided configuration for new users.
88
89              Example:
90              $ sudo firecfg --guide
91
92       --debug
93              Print debug messages.
94
95       -?, --help
96              Print options end exit.
97
98       --list List all firejail symbolic links
99
100       --version
101              Print program version and exit.
102
103
104
105       Example:
106
107       $ 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
120
121

LICENSE

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

SEE ALSO

131       firejail(1), firemon(1), firejail-profile(5), firejail-login(5),  fire‐
132       jail-users(5), jailcheck(1)
133
134
135
1360.9.72                             Jul 2023                         FIRECFG(1)
Impressum