gerbera - UPnP MediaServer

NAME  SYNOPSIS  DESCRIPTION  OPTIONS 

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


Updated 2023-02-15 - jenkler.se | uex.se