docker-nginx-cgit

A Docker image for cGit running over Nginx.

This is a docker image for cGit, a lightweight web interface for git.

Installation

Download this image from the docker hub:

docker pull emarcs/nginx-cgit

Then wait for docker to do its magic.

Usage

To launch the container, just the run command like this:

docker run -d \
  -p 2340:80 \
  --name nginx-git-srv \
  -v /git:/srv/git \
  emarcs/nginx-cgit

In the above example the /git folder of the the host is used inside the /srv/git folder of the container, the HTTP port is mapped on the host on port 2340.

Using a custom Nginx configuration

An example using docker-compose of how to mount a custom configuration for Nginx:

services:
  cgit:
    container_name: nginx-cgit-test
    image: emarcs/nginx-cgit
    ports:
      - 8181:80
    volumes:
      - /srv/git:/srv/git
      # for a custom nginx configuration
      - ${PWD}/default.conf:/etc/nginx/conf.d/default.conf
    environment:
      CGIT_TITLE: 'My awesome git repos'
      CGIT_DESC: 'Presented by Cgit on Docker'
      # check section-from-path in cgit docs
      CGIT_VROOT: '/'
      CGIT_SECTION_FROM_STARTPATH: 1
      CGIT_MAX_REPO_COUNT: 50

Cache

cGit provides a cache mechanism (cf https://git.zx2c4.com/cgit/tree/cgitrc.5.txt ), which will by default store entries in /var/cache/cgit.

You can eventually map this folder to your disk:

docker run -d \
  -p 2340:80 \
  --name nginx-git-srv \
  -v /git:/srv/git \
  -v /mnt/disk/cgit/cache:/var/cache/cgit \
  emarcs/nginx-cgit