===== Install Cgit with Caddy =====

==== Dependencies ====

  * [[https://github.com/caddyserver/xcaddy/releases|xcaddy]] package from releases page.

Install [[https://github.com/aksdb/caddy-cgi|caddy-cgi]]:

<code bash>
xcaddy build --with github.com/aksdb/caddy-cgi/v2
</code>

Install remaining dependencies:

<code bash>
sudo apt install gitolite3 cgit python-is-python3 python3-pygments python3-markdown docutils-common groff
</code>

==== Configuration ====

Make a git user.

<code bash>
sudo adduser --system --shell /bin/bash --group --disabled-password --home /home/git git
</code>

Configure gitolite for the git user in ''%%~/.gitolite.rc%%''.

<code bash>
UMASK => 0027,
GIT_CONFIG_KEYS => 'gitweb.description gitweb.owner gitweb.homepage gitweb.category',
</code>

Add caddy user to the git group.

<code bash>
sudo usermod -aG git caddy
</code>

Configure cgit in ''%%/etc/cgitrc%%'':

<code bash>
#
# cgit config
# see cgitrc(5) for details

css=/cgit/cgit.css
logo=/cgit/cgit.png
favicon=/cgit/favicon.ico

enable-index-links=1
enable-commit-graph=1
enable-log-filecount=1
enable-log-linecount=1
enable-git-config=1

branch-sort=age
repository-sort=name

clone-url=https://git.hyperreal.coffee/$CGIT_REPO_URL git://git.hyperreal.coffee/$CGIT_REPO_URL ssh://git@git.hyperreal.coffee:$CGIT_REPO_URL

root-title=hyperreal.coffee Git repositories
root-desc=Source code and configs for my projects

##
## List of common mimetypes
##
mimetype.gif=image/gif
mimetype.html=text/html
mimetype.jpg=image/jpeg
mimetype.jpeg=image/jpeg
mimetype.pdf=application/pdf
mimetype.png=image/png
mimetype.svg=image/svg+xml

# Enable syntax highlighting
source-filter=/usr/lib/cgit/filters/syntax-highlighting.py

# Format markdown, rst, manpages, text files, html files, and org files.
about-filter=/usr/lib/cgit/filters/about-formatting.sh

##
### Search for these files in the root of the default branch of repositories
### for coming up with the about page:
##
readme=:README.md
readme=:README.org

robots=noindex, nofollow

section=personal-config

repo.url=doom-emacs-config
repo.path=/home/git/repositories/doom-emacs-config.git
repo.desc=My Doom Emacs config
</code>