1gerbera(1) gerbera(1)
2
6 gerbera - UPnP MediaServer
7
9 gerbera [ -i|--ip IP address ] [ -e|--interface interface ] [ -p|--port
10 port ] [ -u|--user username ] [ -c|--config config file ] [
11 -m|--home home dir ] [ -f|--cfgdir config dir ] [ -P|--pidfile
12 pid file ] [ --add-file file ] [ -l|--logfile logfile ] [
13 -d|-daemon ] [ -D|--debug ] [ --compile-info ] [ --create-
14 config ] [ --check-config ] [ -v|--version ] [ -h|--help ]
15
17 This manual page describes the command line parameters for Gerbera. For
18 a detailed documentation please see the README file which is distrib‐
19 uted with Gerbera or visit https://gerbera.io.
20
22 -i, --ip
23 The server will bind to the given IP address, currently we can
24 not bind to multiple interfaces so binding to 0.0.0.0 will not
25 be possible.
26 -e, --interface
28 The server will bind to the given network interface, currently
29 we can only bind to one interface at a time.
30 -p, --port
32 Specify the server port that will be used for the web user in‐
33 terface, for serving media and for UPnP requests, minimum al‐
34 lowed value is 49152. If this option is omitted a default port
35 will be chosen, however, in this case it is possible that the
36 port will change upon server restart.
37 -u, --user
39 Drop privs to user on startup. Make sure all mediafiles are
40 readable by this user. Also make sure that home directory is
41 writable for this user.
42 -c, --config
44 By default Gerbera will search for a file named "config.xml" in
45 the ~/.config/gerbera directory. This option allows you to
46 specify a config file by the name and location of your choice.
47 The file name must be absolute.
48 -m, --home
50 Specify an alternative home directory. By default Gerbera will
51 try to retrieve the users home directory from the environment,
52 then it will look for a the default configuration file (con‐
53 fig.xml).
54 This option is useful in two cases: when the home directory can‐
56 not be retrieved from the environment (in this case you could
57 also use -c to point Gerbera to your configuration file) or when
58 you want to test a new configuration in a non standard location
59 (for example, when setting up daemon mode). In the latter case
60 you can combine this parameter with the parameter described in
61 "Config Directory"
62 -f, --cfgdir
64 The default configuration directory is combined by the users
65 home and the default that equals to .config/gerbera, this option
66 allows you to override the default directory naming. This is
67 useful when you want to set up the server in a nonstandard loca‐
68 tion.
69 --add-file
71 Add the specified file name to the database without UI interac‐
72 tion. The path must be absolute, if path is a directory then it
73 will be added recursively. If path is a file, then only the giv‐
74 en file will be imported.
75 -l, --logfile
77 Do not output log messages to stdout, but redirect everything to
78 a specified file.
79 -D, --debug
81 Enable debug log output.
82 -d, --daemon
84 Daemonize after startup.
85 --compile-info
87 Print the compilation configuration (defaults for used libraries
88 and enabled features) and exit.
89 --create-config
91 Output the default configuration to stdout and exit. Copy the
92 output to your config.xml and adjust to your needs.
93 --check-config
95 Check the current configuration before running the service and
96 exit. Helpful in conjunction with --debug.
97 --version
99 Print version information and exit.
100 -h, --help
102 Print a summary about the available command line options.
103 2021-11-04 gerbera(1)