uggedal / gitoff

Git WWW interface

gitoff
======

Tiny git www interface.

Currently gitoff is developed for OpenBSD and designed
to be served with httpd(8) and slowcgi(8) in a chroot
under /var/www.

Building
--------

Start with building a static libgit2 archive parallel
to this directory:

	cd ..
	ftp -o- https://github.com/libgit2/libgit2/archive/v0.23.4.tar.gz |
	    tar xzf -
	mv libgit2-* libgit2
	mkdir libgit2/build
	cd libgit2/build
	cmake .. -DCURL=OFF -DUSE_OPENSSL=OFF \
	    -DUSE_SSH=OFF -DBUILD_SHARED_LIBS=OFF
	cmake --build .

Then simply compile gitoff:

	make

Installation
------------

Make git repositories available under /var/www/git.

Configure httpd.conf(5) as follows:

	server "git.example.com" {
		listen on * port 80

		root "/cgi-bin/gitoff"
		fastcgi socket "/run/slowcgi.sock"
	}

Copy gitoff and style into place:

	doas cp gitoff /var/www/cgi-bin