From 4f728070b7e7be3301bc66dc24894df12f4f9b14 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Tue, 20 Apr 2021 22:14:14 +0200
Subject: preliminary gitolite3 documentation

---
 SETUP.md | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

(limited to 'SETUP.md')

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
-- 
cgit v1.2.3