firecfg(1) - Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | LICENSE | SEE ALSO | COLOPHON

FIRECFG(1)                    firecfg man page                    FIRECFG(1)

NAME         top

       Firecfg - Desktop integration utility for Firejail software.

SYNOPSIS         top

       firecfg [OPTIONS]

DESCRIPTION         top

       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.

OPTIONS         top

       --clean
              Remove all firejail symbolic links.

       --fix  Fix .desktop files. Some .desktop files use full path to
              executable. Firecfg will check .desktop files in
              /usr/share/applications/, 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, followed 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         top

       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         top

       firejail(1), firemon(1), firejail-profile(5), firejail-login(5)

COLOPHON         top

       This page is part of the Firejail (Firejail security sandbox)
       project.  Information about the project can be found at 
       ⟨https://firejail.wordpress.com⟩.  If you have a bug report for this
       manual page, see ⟨https://firejail.wordpress.com/support/⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨https://github.com/netblue30/firejail.git⟩ on 2018-02-02.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-02-01.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

0.9.53                            Jan 2018                        FIRECFG(1)