NAME

       gerbera - UPnP MediaServer

SYNOPSIS

       gerbera [ -h|--help ] [ -D|--debug ] [ -v|--version ] [ --compile-info ] [ --create-config
               ] [ --create-example-config ] [ --check-config ] [ --print-options ] [ --offline ]
               [ -d|-daemon ] [ -u|--user username ] [ -P|--pidfile pid file ] [ -c|--config
               config file ] [ -f|--cfgdir config dir ] [ -l|--logfile logfile ] [ --add-file
               file ] [ --set-option opt=val ] [ -p|--port port ] [ -i|--ip IP address ] [
               -e|--interface interface ] [ -m|--home home dir ] [ --magic magic ] [ --import-
               mode mt|grb ] [ -l|--debug-mode facilities ]

DESCRIPTION

       This  manual  page  describes  the  command  line  parameters  for Gerbera. For a detailed
       documentation please see the README file  which  is  distributed  with  Gerbera  or  visit
       https://gerbera.io.

OPTIONS

       -i, --ip
              The server will bind to the given IP address, currently we can not bind to multiple
              interfaces so binding to 0.0.0.0 will not be possible.

       -e, --interface
              The server will bind to the given network interface, currently we can only bind  to
              one interface at a time.

       -p, --port
              Specify  the  server port that will be used for the web user interface, for serving
              media and for UPnP requests, minimum allowed value is  49152.  If  this  option  is
              omitted  a  default  port will be chosen, however, in this case it is possible that
              the port will change upon server restart.

       -u, --user
              Drop privs to user on startup. Make sure all mediafiles are readable by this  user.
              Also make sure that home directory is writable for this user.

       -c, --config
              By   default   Gerbera   will   search   for  a  file  named  "config.xml"  in  the
              ~/.config/gerbera directory.  This option allows you to specify a  config  file  by
              the name and location of your choice. The file name must be absolute.

       -m, --home
              Specify  an alternative home directory. By default Gerbera will try to retrieve the
              users home directory from the  environment  (HOME),  then  it  will  look  for  the
              .config/gerbera  directory  in users home. If .config/gerbera was found we will try
              to find the default configuration file (config.xml).

              This option is useful in two cases: when the home  directory  cannot  be  retrieved
              from  the  environment (in this case you could also use -c to point Gerbera to your
              configuration file) or when you want to test a new configuration in a non  standard
              location  (for  example,  when  setting up daemon mode). In the latter case you can
              combine this parameter with the parameter described in "Config Directory"

       -f, --cfgdir
              The default configuration directory is combined by the users home and  the  default
              that  equals  to  .config/gerbera,  this  option allows you to override the default
              directory naming. This is  useful  when  you  want  to  set  up  the  server  in  a
              nonstandard location.

       -f, --magic
              The magic file is set/overwritten. By default it is read from environment variables
              GERBERA_MAGIC_FILE or MEDIATOMB_MAGIC_FILE.

       --add-file
              Add the specified file name to the database without UI interaction. The  path  must
              be absolute, if path is a directory then it will be added recursively. If path is a
              file, then only the given file will be imported.

       --print-options
              Print all option numbers available for use with --set-option.

       --set-option
              Set the specified option number to  its  proper  value  like  in  config.xml.  This
              overwrites values from config.xml. See --print-options for valid options.  Multiple
              options can either be specified sperated by commas or with another  use  of  --set-
              option.

       -l, --logfile
              Do not output log messages to stdout, but redirect everything to a specified file.

       -D, --debug
              Enable debug log output.

       -d, --daemon
              Daemonize after startup.

       --compile-info
              Print  the  compilation  configuration  (defaults  for  used  libraries and enabled
              features) and exit.

       --create-config
              --create-example-config Output the  default/example  configuration  to  stdout  and
              exit.  Copy the output to your config.xml and adjust to your needs.

       --check-config
              Check  the  current  configuration  before running the service and exit. Helpful in
              conjunction with --debug.

       --offline
              Do not answer UPnP requests like browse. This is helpful when running a large  scan
              to  initialize  the database so no client can slow down the import by accessing the
              database.

       --version
              Print version information and exit.

       -h, --help
              Print a summary about the available command line options.

                                            2021-11-04                                 gerbera(1)