Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gerbera(1)							    gerbera(1)

NAME
       gerbera - UPnP MediaServer

SYNOPSIS
       gerbera [ -h|--help ] [ -D|--debug ] [ -v|--version ] [ --compile-info
	       ] [ --create-config=Sections ] [	--create-example-
	       config=Sections ] [ --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 ] [ --rotatelog
	       logfile ] [ --syslog LOG	] [ --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 distrib-
       uted 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 in-
	      terface, for serving media and for UPnP  requests,  minimum  al-
	      lowed  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 can-
	      not  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 loca-
	      tion.

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

       --add-file
	      Add  the specified file name to the database without UI interac-
	      tion. The	path must be absolute, if path is a directory then  it
	      will be added recursively. If path is a file, then only the giv-
	      en 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 con-
	      fig.xml. This overwrites values from config.xml. See --print-op-
	      tions  for valid options.	 Multiple options can either be	speci-
	      fied 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.

       -l, --rotatelog
	      Do not output log	messages to stdout, but	redirect everything to
	      a	specified rotating file. It will rotate	10 files at 5MB.

       -l, --syslog
	      Do not output log	messages to stdout, but	redirect everything to
	      syslog. The optional argument contains the syslog	 facility.  If
	      no argument is given LOG_USER is used.

       -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=Section
	      --create-example-config=Section  Output the default/example con-
	      figuration to stdout and exit.  Copy the	output	to  your  con-
	      fig.xml  and adjust to your needs.  You can provide the names of
	      sections separated by | to get the section only.

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

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gerbera&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help