NAME

       gerbera - UPnP MediaServer

SYNOPSIS

       gerbera [ -i|--ip IP address ] [ -e|--interface interface ] [ -p|--port port ] [ -u|--user
               username ] [ -c|--config config file ] [ -m|--home home dir ] [ -f|--cfgdir config
               dir ] [ -P|--pidfile pid file ] [ --add-file file ]  [ -l|--logfile logfile ] [
               -d|-daemon ] [ -D|--debug ] [ --compile-info ] [ --create-config ] [ --check-
               config ] [ --offline ] [ -v|--version ] [ -h|--help ]

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

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

       -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
              Output the default 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)