diff options
author | Ludovic Chabant <ludovic@chabant.com> | 2019-01-30 06:06:53 +0000 |
---|---|---|
committer | Drew DeVault <sir@cmpwn.com> | 2019-02-01 10:05:56 +0100 |
commit | 0270d908f8e3f11769035d3ccb41e761cad57e5b (patch) | |
tree | a0168396feb5d4060ed4e9d4b307933401ac67a2 /hg.sr.ht/installation.md | |
parent | 1d1794752b06224744530f7922d3f9a1c69b573c (diff) | |
download | sr.ht-docs-0270d908f8e3f11769035d3ccb41e761cad57e5b.tar.gz |
Add mercurial docs
Diffstat (limited to 'hg.sr.ht/installation.md')
-rw-r--r-- | hg.sr.ht/installation.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/hg.sr.ht/installation.md b/hg.sr.ht/installation.md new file mode 100644 index 0000000..23a58eb --- /dev/null +++ b/hg.sr.ht/installation.md @@ -0,0 +1,36 @@ +hg.sr.ht is the hg repository hosting service for the sr.ht network. + +# Installation + +hg.sr.ht is a standard sr.ht web service and can be installed through the +[standard procedure](/installation.md). However, there are several additional +steps required. + +## Repository storage + +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. + +## SSH dispatch + +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](../git.sr.ht/installation.md#ssh-dispatch) 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`. + +## Cronjobs + +You must also configure `hgsrht-periodic` to run periodically with your +favorite cron daemon. We recommend the following crontab: + + */20 * * * * hgsrht-periodic + |