hyperreal.coffee

Install Cgit with Caddy

Dependencies

Install caddy-cgi:

1xcaddy build --with github.com/aksdb/caddy-cgi/v2

Install remaining dependencies:

1sudo apt install gitolite3 cgit python-is-python3 python3-pygments python3-markdown docutils-common groff

Configuration

Make a git user.

1sudo adduser --system --shell /bin/bash --group --disabled-password --home /home/git git

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

1UMASK => 0027,
2GIT_CONFIG_KEYS => 'gitweb.description gitweb.owner gitweb.homepage gitweb.category',

Add caddy user to the git group.

1sudo usermod -aG git caddy

Configure cgit in /etc/cgitrc:

 1#
 2# cgit config
 3# see cgitrc(5) for details
 4
 5css=/cgit/cgit.css
 6logo=/cgit/cgit.png
 7favicon=/cgit/favicon.ico
 8
 9enable-index-links=1
10enable-commit-graph=1
11enable-log-filecount=1
12enable-log-linecount=1
13enable-git-config=1
14
15branch-sort=age
16repository-sort=name
17
18clone-url=https://git.hyperreal.coffee/$CGIT_REPO_URL git://git.hyperreal.coffee/$CGIT_REPO_URL ssh://git@git.hyperreal.coffee:$CGIT_REPO_URL
19
20root-title=hyperreal.coffee Git repositories
21root-desc=Source code and configs for my projects
22
23##
24## List of common mimetypes
25##
26mimetype.gif=image/gif
27mimetype.html=text/html
28mimetype.jpg=image/jpeg
29mimetype.jpeg=image/jpeg
30mimetype.pdf=application/pdf
31mimetype.png=image/png
32mimetype.svg=image/svg+xml
33
34# Enable syntax highlighting
35source-filter=/usr/lib/cgit/filters/syntax-highlighting.py
36
37# Format markdown, rst, manpages, text files, html files, and org files.
38about-filter=/usr/lib/cgit/filters/about-formatting.sh
39
40##
41### Search for these files in the root of the default branch of repositories
42### for coming up with the about page:
43##
44readme=:README.md
45readme=:README.org
46
47robots=noindex, nofollow
48
49section=personal-config
50
51repo.url=doom-emacs-config
52repo.path=/home/git/repositories/doom-emacs-config.git
53repo.desc=My Doom Emacs config

Reply to this post by email ↪