Ubuntu Manpage: gotwebd.conf — gotwebd configuration file

NAME

     gotwebd.conf — gotwebd configuration file

DESCRIPTION

     gotwebd.conf is the run-time configuration file for gotwebd(8).

     The file format is line-based, with one configuration directive per line.  Any lines
     beginning with a ‘#’ are treated as comments and ignored.

     Macros can be defined that are later expanded in context.  Macro names must start with a
     letter, digit, or underscore, and may contain any of those characters, but may not be
     reserved words.  Macros are not expanded inside quotes.  For example:

           lan_addr = "192.168.0.1"
           listen on $lan_addr

     Paths mentioned in gotwebd.conf must be relative to /var/www, the chroot(2) environment of
     httpd(8).

GLOBAL CONFIGURATION

     The available global configuration directives are as follows:

     chroot path
             Set the path to the chroot(2) environment of httpd(8).  If not specified then
             /var/www will be used.

     prefork number
             Run the specified number of server processes.

     unix_socket on | off
             Controls whether the servers will listen on unix sockets by default.

     unix_socket_name path
             Set the path to the default unix socket.

SERVER CONFIGURATION

At least one server context must exist for gotwebd(8) to function. In case no server
context is defined in the configuration file, a default server context will be used, which
listens on a unix socket at /var/www/run/gotweb.sock and uses default parameters for all
applicable settings.

A server context is declared with a unique name, followed by server-specific configuration
directives inside curly braces:

server name {...}

gotwebd(8) is compatible with TLS Server Name Indication (SNI), provided the name of a
server defined in gotwebd.conf corresponds to the name of a server defined in httpd.conf(5).

The available server configuration directives are as follows:

custom_css path
Set the path to a custom Cascading Style Sheet (CSS) to be used. If this option is
not specified then a default style sheet will be used.

listen on address port number
Configure an address and port for incoming FCGI TCP connections. Valid address
arguments are hostnames, IP4 addresses, IPv6 addresses, and network interface names.
The port argument may be number or a service name defined in services(5).

May be specified multiple times to build up a list of listening sockets. However, a
given combination of address and port may only be used by one server.

If a network interface name is given as address argument then gotwebd(8) will obtain
the list of addresses on this interface only on startup. Any future changes to the
address configuration of the interface will be ignored.

listen on socket off
Disable use of unix socket.

listen on socket path
Set the path to the unix socket used by the server.

logo path
Set the path to an image file containing a logo to be displayed.

logo_url url
Set a hyperlink for the logo.

max_commits_display number
Set the maximum amount of commits displayed per page.

max_repos number
Set the maximum amount of repositories gotwebd(8) will work with.

max_repos_display number
Set the maximum amount of repositories displayed on the index screen.

repos_path path
Set the path to the directory which contains Git repositories that the server should
publish.

respect_exportok on | off
Set whether to display the repository only if it contains the magic
git-daemon-export-ok file.

show_repo_age on | off
Toggle display of last repository modification date.

show_repo_cloneurl on | off
Toggle display of clone URLs for a repository. This requires the creation of a
cloneurl file inside the repository which contains one URL per line.

show_repo_description on | off
Toggle display of the repository description. The description file in the
repository should be updated with an appropriate description.

show_repo_owner on | off
Set whether to display the repository owner. Displaying the owner requires owner
information to be added to the config file in the repository. gotwebd(8) will parse
owner information from either a [gotweb] or a [gitweb] section. For example:

[gotweb]
owner = "Your Name"

site_link string
Set the displayed site link name for the index page.

site_name string
Set the displayed site name title.

site_owner string
Set the displayed site owner.

show_site_owner on | off
Toggle display of the site owner.

FILES

     /etc/gotwebd.conf
             Default location of the gotwebd.conf configuration file.

EXAMPLES