Cgit is an attempt to create a fast web interface for the git scm, using a builtin cache to decrease server io-pressure.
Installing cgit is rather simple as it's available in the Community repository: Template:Cli
In order to actually use cgit you will of course also need to have some webserver installed on your system, like for example Apache.
# # cgit configuration for apache # ScriptAlias /cgit/ "/usr/lib/cgit/cgit.cgi/" Alias /cgit-css "/usr/share/webapps/cgit/" <Directory "/usr/share/webapps/cgit/"> AllowOverride None Options None Order allow,deny Allow from all </Directory> <Directory "/usr/lib/cgit/"> AllowOverride None Options ExecCGI FollowSymlinks Order allow,deny Allow from all </Directory>
Before you can start adding repositories you will first have to create the basic cgit configuration file at Template:Filename. You should at least specify the Stylesheet:
# # cgit config # css=/cgit-css/cgit.css
Now you can add your repos:
# # List of repositories. # This list could be kept in a different file (e.g. '/etc/cgitrepos') # and included like this: # include=/etc/cgitrepos # repo.url=MyRepo repo.path=/srv/git/MyRepo.git repo.desc=This is my git repository repo.url=MyOtherRepo repo.path=/srv/git/MyOtherRepo.git repo.desc=That's my other git repository
For detailed documentation about the available settings in this configuration file, please see the manage (`man cgitrc`).