From 7f94385c3468e234b93f1185f321e5479a327397 Mon Sep 17 00:00:00 2001
From: bt <bt@web>
Date: Wed, 17 Jan 2024 12:18:19 -0500
Subject:

---
 wiki/cgit.mdwn | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

(limited to 'wiki')

diff --git a/wiki/cgit.mdwn b/wiki/cgit.mdwn
index 0e62b61..d800234 100644
--- a/wiki/cgit.mdwn
+++ b/wiki/cgit.mdwn
@@ -1 +1,39 @@
 This page contains a comprehensive guide to setting up cgit on NearlyFreeSpeech. It is assumed that you already have an account with NFS and also have access to a "site" online.
+
+Most of the following has been lifted from [NearlyFreeSpeech cgit application walkthrough](https://members.nearlyfreespeech.net/wiki/Applications/Cgit) but has been tweaked and updated.
+
+## Building cgit
+
+The following assumes that you wish to have cgit running at the top-level of your chosen domain (ie. git.example.com)
+
+SSH into your account the download and unpack the latest release:
+
+    git clone git://git.zx2c4.com/cgit cgit-src
+    cd cgit-src
+
+Create a cgit.conf file with desired locations:
+
+    CGIT_SCRIPT_PATH = /home/public
+    CGIT_DATA_PATH = $(CGIT_SCRIPT_PATH)
+    CGIT_CONFIG = $(CGIT_SCRIPT_PATH)/cgitrc
+    CACHE_ROOT = $(CGIT_SCRIPT_PATH)/cgitcache
+    prefix = $(CGIT_SCRIPT_PATH)/local
+
+Get the git sources (needed to build libgit):
+
+    git submodule init
+    git submodule update
+
+Build and install it:
+
+    gmake install
+
+## Configuration
+
+Make a text file where you specified for CGIT_CONFIG, and e.g. add the following:
+
+    css=/cgit/cgit.css
+    logo=/cgit/cgit-trans.png
+    root-title=My Git Repositories
+
+**And you should be good to go!**
-- 
cgit v1.2.3-54-g00ecf