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 /etc/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).
              - automatically loads and forces the AppArmor profile "firejail-default".

OPTIONS

       --add-users user [user]
              Add the list of users to Firejail user access database.

              Example:
              $ sudo firecfg --add-users dustin lucas mike eleven

       --bindir=directory
              Create and search symbolic links in  directory  instead  of  the  default  location
              /usr/local/bin.  Directory should precede /usr/bin and /bin in the PATH environment
              variable.

       --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.

       --guide
              Guided configuration for new users.

              Example:
              $ sudo firecfg --guide

       --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),   firejail-users(5),
       jailcheck(1)