gerbera(1)

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 ] [ -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

\FC-i\F[], \FC--ip\F[]
    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.

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

\FC-p\F[], \FC--port\F[]
    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.

\FC-u\F[], \FC--user\F[]
    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.

\FC-c\F[], \FC--config\F[]
    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.

\FC-m\F[], \FC--home\F[]
    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"

\FC-f\F[], \FC--cfgdir\F[]
    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.

\FC--add-file\F[]
    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.

\FC-l\F[], \FC--logfile\F[]
    Do not output log messages to stdout, but redirect everything to a specified file.

\FC-D\F[], \FC--debug\F[]
    Enable debug log output.

\FC-d\F[], \FC--daemon\F[]
    Daemonize after startup.

\FC--compile-info\F[]
    Print the compilation configuration (defaults for used libraries and enabled features) and exit.

\FC--create-config\F[]
    Output the default configuration to stdout and exit. Copy the output to your config.xml and adjust to your needs.

\FC--check-config\F[]
    Check the current configuration before running the service and exit. Helpful in conjunction with --debug.

\FC--version\F[]
    Print version information and exit.

\FC-h\F[], \FC--help\F[]
    Print a summary about the available command line options.