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

gotd.confgotd configuration file

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

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

The available global configuration directives are as follows:

path
Set the path to the unix socket which gotd(8) should listen on. If not specified, the path /var/run/gotd.sock will be used.
group
Set the group, defined in the group(5) file, which is allowed to access gotd(8) via gotsh(1). The gotd(8) user must be a secondary member of this group. If not specified, the group _gotsh will be used.
user
Set the user which will run gotd(8). Initially, gotd(8) requires root privileges in order to create its unix socket and start child processes in a chroot(2) environment. Afterwards, gotd(8) drops privileges to the specified user. If not specified, the user _gotd will be used.

At least one repository context must exist for gotd(8) to function.

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

repository name {...}

got(1) and git(1) clients can connect to a repository by including the repository's unique name in the request URL. Clients appending the string “.git” to the name will also be accepted.

If desired, the name may contain path-separators, “/”, to expose repositories as part of a virtual client-visible directory hierarchy.

The available repository configuration directives are as follows:

path
Set the path to the Git repository.

/etc/gotd.conf
Location of the gotd.conf configuration file.

# Default unix_group and user values:
unix_group _gotsh
user _gotd

# This repository can be accessed via ssh://user@example.com/src
repository "src" {
	path "/var/git/src.git"
}

# This repository can be accessed via
# ssh://user@example.com/openbsd/ports
repository "openbsd/ports" {
	path "/var/git/ports.git"
}

got(1), gotsh(1), group(5), gotd(8)

November 8, 2022 OpenBSD 7.2