hg.sr.ht is the hg repository hosting service for the sr.ht network.
hg.sr.ht is a standard sr.ht web service and can be installed through the standard procedure. However, there are several additional steps required.
You will need to set up a directory for repositories to be stored in - we
suggest /var/lib/hg/. Also configure a hg user and assign ownership over
/var/lib/hg/ to this user. The hg.sr.ht package will automatically prepare
these for you. If you do not use the package, you must create the user yourself
and ensure that the hg.sr.ht web application runs as this user.
At the moment, hg.sr.ht uses git.sr.ht's SSH dispatcher, which you need to setup as the system-wide SSH authorization hook. See the git.sr.ht documentation for more information.
Once this is done, you need to make the hg.sr.ht authorization hook be part of
the SSH dispatching, via the hgsrht-keys and hgsrht-shell scripts. See the
[dispatch] section of you hg.sr.ht configuration for details on how this
works.
Authorization logs are written to hg-srht-shell.
You must also configure hgsrht-periodic to run periodically with your
favorite cron daemon. We recommend the following crontab:
*/20 * * * * hgsrht-periodicIf you'd like to generate clonebundles (which require more disk space but dramatically speed up cloning large repositories), also add a nightly task for running the script:
0 * * * * hgsrht-clonebundleshg.sr.ht does not do this for you - you need to wire it up in nginx. Here's an example config:
location = /authorize {
proxy_pass http://127.0.0.1:5001;
proxy_pass_request_body off;
proxy_set_header Content-Length "";
proxy_set_header X-Original-URI $request_uri;
}
location ~ ^/[~^][a-z0-9_]+/[a-zA-Z0-9_.-]+/\.hg.*$ {
auth_request /authorize;
root /var/lib/mercurial;
}
commit 5b2178aae325c1abefd6174be9a73a2aa714d4ee Author: Evan Hanson <evhan@foldling.org> Date: 2019-04-20T22:28:27 Fix user endpoint anchors in lists.sr.ht API docs