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