humungus - humungus

i am gravely disappointed

i will give you safe passage in the wasteland

overview - docs

HUMUNGUS(8) System Manager's Manual HUMUNGUS(8)

humungus — hg (mercurial) server

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
By default, only readonly access is granted to a user named "anon".

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.

Enable federation and start humungus.

humungus> ./humungus setconfig enablefedi 1
humumgus> ./humungus

Shut it down.

humumgus> ./humungus control stop
May 15, 2025 OpenBSD 7.5