1gerbera(1) gerbera(1)
2
6 gerbera - UPnP MediaServer
7
9 gerbera [ -i IP address ] [ -e interface ] [ -p port ] [ -c config file
10 ] [ -m home dir ] [ -f config dir ] [ -a path ] [ -l logfile ]
11 [ -D ] [ --compile-info ] [ --version ] [ -h ]
12
14 This manual page describes the command line parameters for Gerbera. For
15 a detailed documentation please see the README file which is distrib‐
16 uted with Gerbera or visit https://gerbera.io.
17
19 -i, --ip
20 The server will bind to the given IP address, currently we can
21 not bind to multiple interfaces so binding to 0.0.0.0 will not
22 be possible.
23 -e, --interface
25 The server will bind to the given network interface, currently
26 we can only bind to one interface at a time.
27 -p, --port
29 Specify the server port that will be used for the web user in‐
30 terface, for serving media and for UPnP requests, minimum al‐
31 lowed value is 49152. If this option is omitted a default port
32 will be chosen, however, in this case it is possible that the
33 port will change upon server restart.
34 -c, --config
36 By default Gerbera will search for a file named "config.xml" in
37 the ~/.config/gerbera directory. This option allows you to spec‐
38 ify a config file by the name and location of your choice. The
39 file name must be absolute.
40 -m, --home
42 Specify an alternative home directory. By default Gerbera will
43 try to retrieve the users home directory from the environment,
44 then it will look for a .gerbera directory in users home. If
45 .gerbera was found we will try to find the default configuration
46 file (config.xml), if not found we will create both, the .Ger‐
47 bera directory and the default config file.
48 This option is useful in two cases: when the home directory can
50 not be retrieved from the environment (in this case you could
51 also use -c to point Gerbera to your configuration file or when
52 you want to create a new configuration in a non standard loca‐
53 tion (for example, when setting up daemon mode). In the latter
54 case you can combine this parameter with the parameter described
55 in Section 5.6, "Config Directory"
56 -f, --cfgdir
58 The default configuration directory is combined out of the users
59 home and the default that equals to .gerbera, this option allows
60 you to override the default directory naming. This is useful
61 when you want to setup the server in a nonstandard location, but
62 want that the default configuration to be written by the server.
63 -P, --pidfile
65 Specify a file that will hold the server process ID, the file‐
66 name must be absolute.
67 -a, --add
69 Add the specified directory or file name to the database without
70 UI interaction. The path must be absolute, if path is a directo‐
71 ry then it will be added recursively. If path is a file, then
72 only the given file will be imported.
73 -l, --logfile
75 Do not output log messages to stdout, but redirect everything to
76 a specified file.
77 -D, --debug
79 Enable debug log output.
80 --compile-info
82 Print the configuration summary (used libraried and enabled fea‐
83 tures) and exit.
84 --version
86 Print version information and exit.
87 -h, --help
89 Print a summary about the available command line options.
90 2017-09-05 gerbera(1)