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.
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.
ssh access may be enabled with the command line
setconfig command.
humungus setconfig sshenabled 1 humungus setconfig sshlistenaddr localhost:2222 humungus gensshkey
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