gerbera(1)

NAME
gerbera - UPnP MediaServer

SYNOPSIS
gerbera
[ -h|--help ] [ -D|--debug ] [ -v|--version ] [ --compile-info ] [ --create-config=Sections ] [ --create-example-config=Sections ] [ --create-advanced-config=Sections ] [ --check-config ] [ --print-options ] [ --offline ] [ --drop-tables ] [ --init-lastfm ] [ -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 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 (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 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-f\F[], \FC--magic\F[]
    The magic file is set/overwritten. By default it is read from environment variables GERBERA_MAGIC_FILE or MEDIATOMB_MAGIC_FILE.

\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--print-options\F[]
    Print all option numbers available for use with --set-option.

\FC--set-option\F[]
    Set the specified option number to its proper value like in config.xml. This overwrites values from config.xml. See --print-options for valid options. Multiple options can either be specified sperated by commas or with another use of --set-option.

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

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

\FC-l\F[], \FC--syslog\F[]
    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.

\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=Section\F[]

\FC--create-example-config=Section\F[]

\FC--create-advanced-config=Section\F[]
    Output the default/example/advanced example configuration to stdout and exit. Copy the output to your config.xml and adjust to your needs. You can provide the names of sections separated by | to get the section only.

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

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

\FC--drop-tables\F[]
    Drop all database tables and exit

\FC--init-lastfm\F[]
    Get Last.FM session key based on apiKey and apiSecret in config. Requires Gerbera to be build with support for Last.FM API 2.0.

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

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