Git Web frontend with stagit(1)

Tags:  tutorials

stagit(1) reads Git repositories and generates static pages for them with a predefined CSS stylesheet (I said stylesheet twice!), a website logo and a favicon.


Install stagit(1):

$ git clone git://
$ cd stagit
# doas make install clean

I like to have everything stagit(1)-related inside /var/www/htdocs/ along with the actual repositories, but you can choose any other directory.

Store the stylesheet, logo and favicon inside. You’ll find the stylesheet inside the stagit(1) repository you cloned earlier; it’s called style.css. For the logo and favicon, just make your own, but make sure they are in PNG format and have the same names as below.

# cp logo.png favicon.png style.css /var/www/htdocs/

You can edit the stylesheet to your likings, but if you’re afraid that you’ll mess things up, play around with the colors only.

Here I created a repository named repo in /var/www/htdocs/ I will now make a directory to store the files that stagit(1) will produce. I like to give it the same name as the repository but without the .git extension:

# mkdir /var/www/htdocs/

Create symlinks for the stylesheet, logo and favicon inside the directory you just created:

$ cd /var/www/htdocs/
# ln -s ../style.css ../logo.png ../favicon.png .

Run stagit(1) and generate the static page for your repository. This has to be done inside the directory you just created since stagit(1) stores the files in the working directory. Make sure that you give it the .git directory (i.e the actual repository):

# stagit ../repo.git

Go to the top-level Git directory and generate an index.html file which is your Git server’s homepage where all repositories will be listed. Again, you give it the actual repositories:

$ cd /var/www/htdocs/
# stagit-index repo.git > index.html

I’ve made a simple script to automate the generation process:


cd /var/www/htdocs/
for dir in $(ls | grep "git"); do
	cd ${dir%.*} && stagit ../${dir} && cd .. && echo "updating ${dir}: ok"
stagit-index $(ls | grep "git") > index.html && echo "creating index.html. ok"

Fire up a browser and go to and you should see everything. Success!