Scroll to navigation

GOTWEBD.CONF(5) File Formats Manual GOTWEBD.CONF(5)

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:

path
Set the path to the chroot(2) environment of httpd(8). If not specified then /var/www will be used.
number
Run the specified number of server processes.
on | off
Controls whether the servers will listen on unix sockets by default.
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 {...}

The first server defined is used if the requested hostname is not matched by any server block.

The available server configuration directives are as follows:

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.
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.

Disable use of unix socket.
path
Set the path to the unix socket used by the server.
Set the path to an image file containing a logo to be displayed.
url
Set a hyperlink for the logo.
number
Set the maximum amount of commits displayed per page.
number
Set the maximum amount of repositories gotwebd(8) will work with.
number
Set the maximum amount of repositories displayed on the index screen.
path
Set the path to the directory which contains Git repositories that the server should publish.
on | off
Set whether to display the repository only if it contains the magic git-daemon-export-ok file.
on | off
Toggle display of last repository modification date.
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.
on | off
Toggle display of the repository description. The description file in the repository should be updated with an appropriate description.
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"
Set the displayed site link name for the index page.
string
Set the displayed site name title.
string
Set the displayed site owner.
on | off
Toggle display of the site owner.

FILES

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

EXAMPLES

These are the currently configurable items for gotwebd(8) with their default values.

#
# gotwebd options
# all paths relative to /var/www (httpd chroot jail)
#

prefork 3

server "localhost-unix" {
	repos_path "/got/public"
	listen on socket "/run/gotweb.sock"

	site_name       "my public repos"
	site_owner      "Got Owner"
	site_link       "repos"

	logo   "got.png"
	logo_url   "https://gameoftrees.org"

	# on by default
	#show_site_owner  on
	#show_repo_owner  on
	#show_repo_age  on
	#show_repo_description on
	#show_repo_cloneurl  on
	#respect_exportok off

	#max_repos   0
	#max_repos_display  25
	#max_commits_display  25
}

# Example server context for FCGI over TCP connections:
#server "localhost-tcp" {
#	repos_path "/got/public"
#	listen on socket off
#	listen on 127.0.0.1 port 9000
#	listen on ::1 port 9000
#}

SEE ALSO

got(1), httpd.conf(5), services(5), gotwebd(8), httpd(8)

August 16, 2025 Debian