Scroll to navigation

gerbera(1) gerbera(1)

NAME

gerbera - UPnP MediaServer

SYNOPSIS


gerbera
[ -i IP address ] [ -e interface ] [ -p port ] [ -c config file ] [ -m home dir ] [ -f config dir ] [ -a path ] [ -l logfile ] [ -D ] [ --compile-info ] [ --version ] [ -h ]

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.
-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 a .gerbera directory in users home. If .gerbera was found we will try to find the default configuration file (config.xml), if not found we will create both, the .Gerbera directory and the default config file.

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 create 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 Section 5.6, "Config Directory"

-f, --cfgdir
The default configuration directory is combined out of the users home and the default that equals to .gerbera, this option allows you to override the default directory naming. This is useful when you want to setup the server in a nonstandard location, but want that the default configuration to be written by the server.
-P, --pidfile
Specify a file that will hold the server process ID, the filename must be absolute.
-a, --add
Add the specified directory or 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.
--compile-info
Print the configuration summary (used libraried and enabled features) and exit.
--version
Print version information and exit.
-h, --help
Print a summary about the available command line options.
2017-09-05