FIRECFG(1) firecfg man page FIRECFG(1)
NAME
Firecfg - Desktop integration utility for Firejail software.
SYNOPSIS
firecfg [OPTIONS]
DESCRIPTION
Firecfg is the desktop integration utility for Firejail sandbox. It
allows the user to sandbox applications automatically by clicking on
desktop manager icons and menus.
The integration covers:
- programs started in a terminal - typing "firefox" would be
enough to start a sandboxed Firefox browser
- programs started by clicking on desktop manager menus - all
major desktop managers are supported
- programs started by clicking on file icons in file manager -
only Cinnamon, KDE, LXDE/LXQT, MATE and XFCE desktop managers
are supported in this moment
To set it up, run "sudo firecfg" after installing Firejail software.
The same command should also be run after installing new programs. If
the program is supported by Firejail, the symbolic link in
/usr/local/bin will be created. For a full list of programs supported
by default run "cat /usr/lib/firejail/firecfg.config".
For user-driven manual integration, see DESKTOP INTEGRATION section in
man 1 firejail.
DEFAULT ACTIONS
The following actions are implemented by default by running sudo
firecfg:
- set or update the symbolic links for desktop integration;
- add the current user to Firejail user access database
(firecfg --add-users);
-fix desktop files in $HOME/.local/share/applications/ (firecfg
--fix).
OPTIONS
--add-users user [user]
Add the list of users to Firejail user access database.
Example:
$ sudo firecfg --add-users dustin lucas mike eleven
--clean
Remove all firejail symbolic links.
--fix Fix .desktop files. Some .desktop files use full path to exe‐
cutable. Firecfg will check .desktop files in /usr/share/appli‐
cations/, replace full path by name if it is in PATH, and write
result to $HOME/.local/share/applications/. This action is
done by default when running "sudo firecfg". We have it as a
separate option for regular users.
--fix-sound
Create a proper ~/.config/pulse/client.conf file without shm
support. On some PulseAudio versions, shared memory support
(shm) breaks the process ID namespace. PulseAudio software was
designed a long time ago, and the introduction of PID namespace
in Linux kernel breaks their design. This was reportedly fixed
in PulseAudio version 9. If you have sound problems on your
system, run "firecfg --fix-sound" command in a terminal, fol‐
lowed by logout/login in order to apply the changes.
--debug
Print debug messages.
-?, --help
Print options end exit.
--list List all firejail symbolic links
--version
Print program version and exit.
Example:
$ sudo firecfg
/usr/local/bin/firefox created
/usr/local/bin/vlc created
[...]
$ firecfg --list
/usr/local/bin/firefox
/usr/local/bin/vlc
[...]
$ sudo firecfg --clean
/usr/local/bin/firefox removed
/usr/local/bin/vlc removed
[...]
LICENSE
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.
Homepage: https://firejail.wordpress.com
SEE ALSO
firejail(1), firemon(1), firejail-profile(5), firejail-login(5) fire‐
jail-users(5)
0.9.56 Sep 2018 FIRECFG(1)
Advertisements
