update SETUP doc and gitolite hook

1 files changed, 64 insertions, 14 deletions

diff --git a/SETUP.md b/SETUP.md
index 25b7508..6ec5e2a 100644
--- a/SETUP.md
+++ b/SETUP.md
@@ -1,3 +1,5 @@
+# Setting up source hosting
+
 NB! Some system-specific strings are used
 which you may need to adapt depending on your local setup:
 
@@ -12,35 +14,83 @@ Gitolite service need to know the public SSH key of its administrator.
 You can let it ask during install,
 but it may be more convenient to preconfigure that information instead.
 
-One way to preconfigure the needed SSH public key
-is to run this command
+**On your local host**,
+print your SSH public key
+e.g. with this command
 **from your personal system**
-which then **logs into the server system** using ssh
 (adapt to replace ed25519 if your SSH keypair use a different algorithm):
 
-	printf 'gitolite3 gitolite3/adminkey select "%q"' $(cat ~/.ssh/id_ed25519.pub) | ssh {{githost}} sudo debconf-set-selections
-
-Another way is to somehow locate your public SSH key
-and run this command
-(adapt to replace $YOURKEY with your actual key):
-
-	echo gitolite3 gitolite3/adminkey select "$YOURKEY" | sudo debconf-set-selections
+	cat ~/.ssh/id_ed25519.pub
 
-Then preconfigure git user,
+**On the server**,
+preconfigure git user
+with above public key (the whole line without newline) as $YOURKEY,
 and install needed packages:
 
+	echo gitolite3 gitolite3/adminkey select "$YOURKEY" | sudo debconf-set-selections
 	echo gitolite3 gitolite3/gituser select git | sudo debconf-set-selections
-	sudo apt install gitolite3 git-daemon-sysvinit cgit cmark highlight
+	sudo apt install gitolite3 myrepos git-daemon-sysvinit cgit cmark highlight
 
 
 ## Configure git access
 
-FIXME
+**On your local host**,
+Clone the gitolite3 settings repository:
+
+	git clone git@{{githost}}:gitolite-admin
+
+**On your local host**,
+edit the file gitolite.conf,
+e.g. add these likes to add repository "foobar":
+
+	FIXME
+
+
+## Enable hook
+
+**On the server**,
+clone the redpill feature project for source-hosting
+and register with myrepos (to ease later update):
+
+	mkdir --parents /usr/local/share/redpill
+	cd /usr/local/share/redpill
+	git clone https://source.redpill.dk/source-hosting.git
+	mr reg
+
+Edit the file `/etc/gitolite3/gitolite.rc`
+to have `LOCAL_CODE` point into the project cloned above,
+i.e. the line should look like this:
+
+	LOCAL_CODE =>  "/usr/local/share/redpill/source-hosting/lib/gitolite3",
+
+Refresh gitolite setup
+by running this command:
+
+	sudo -u git gitolite setup
+
+
+## Web export
+
+FIXME: move to separate feature
+
+**On the server**,
+grant access for gitolite to write below /var/www
+with this command:
+
+	FIXME
+
+**On your local host**,
+edit the file gitolite.conf
+to add FIXME to repos that should be exported for web publishing,
+e.g. add these likes to add repository "foobar":
+
+	FIXME
 
 
 ## Configure web access
 
-Adapt the file `/etc/default/git-daemon`:
+**On the server**,
+adapt the file `/etc/default/git-daemon`:
 
 	GIT_DAEMON_ENABLE=true
 	GIT_DAEMON_USER=gitdaemon