preliminary gitolite3 documentation

1 files changed, 22 insertions, 2 deletions

diff --git a/SETUP.md b/SETUP.md
index 9f81afe..25b7508 100644
--- a/SETUP.md
+++ b/SETUP.md
@@ -8,9 +8,29 @@ githost: {{githost}}
 
 ## Prerequisites
 
-Install needed packages:
+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.
 
-	sudo apt install git git-daemon-sysvinit cgit cmark highlight
+One way to preconfigure the needed SSH public key
+is to run 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
+
+Then preconfigure git user,
+and install needed packages:
+
+	echo gitolite3 gitolite3/gituser select git | sudo debconf-set-selections
+	sudo apt install gitolite3 git-daemon-sysvinit cgit cmark highlight
 
 
 ## Configure git access