summaryrefslogtreecommitdiff
path: root/wiki/cgit.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'wiki/cgit.mdwn')
-rw-r--r--wiki/cgit.mdwn38
1 files changed, 38 insertions, 0 deletions
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!**