NAME
humungus
—
hg (mercurial) server
DESCRIPTION
The humungus
daemon provides a web
interface to mercurial source repositories. It allows changeset and file
browsing. Write access via ssh is also optionally provided.
Repositories should be cloned into the repos directory.
The admin
command can be used to adjust
ordering and add descriptions. It also allows the creation and setup of
users for write access.
The initial screen shows the current repo listing. New repos may be added using the [a]dd command. Only repos added via the admin interface will be accessible.
ssh access may be enabled by editing the server [o]ptions in the admin. The enabled option must be set to "yes". The listen address must be distinct from the web address. By default, only readonly access is granted to a user named "anon".
Users may be managed via the [u]ser menu. A public key is required. ed25519 keys are recommended, since they're easier to paste. "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5A..." Users are only granted write access to named repos, or "*" for all repos.
The control
command controls a running
humungus
process.
- stop
- Stop the running instance.
The setconfig
command allows tuning some
other options.
- enablefedi 1
- Enable ActivityPub federation.
- listenaddr addr:port
- Change the web listening address.
Documentation will be rendered from mdoc format to HTML using mandoc. The files searched are docs/{intro,reponame}.[183].
Downloads may be placed into the downloads/reponame directory.
EXAMPLES
Enable federation and start humungus.
humungus> ./humungus setconfig enablefedi 1 humumgus> ./humungus
Shut it down.
humumgus> ./humungus control stop