GitWeb Docker Image

Lightweight Docker image containing an Nginx webserver to visualize
git repositories (through GitWeb) and provide read-only access
to them over HTTP.

Image source at: https://github.com/rockstorm101/gitweb-docker

Basic Use Case

docker run -v /path/to/repos:/srv/git:ro -p 80:80 rockstorm/gitweb

Your repositories should be visible at http://localhost.

You should be able to clone/fetch/pull your repositories like:

git clone http://localhost/your-repo.git

Customization

The provided nginx.conf and gitweb.conf files are the default
configurations for the Nginx webserver and GitWeb (the
repository visualizer) respectively. To override them just mount your
custom files at:

services:
  gitweb:
    ...
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - ./gitweb.conf:/etc/gitweb.conf:ro

By default, a very basic configuration of Nginx is provided. For more
advanced configuration options please consult the official Nginx
documentation.

Apply a Theme

To apply a theme to GitWeb like Stefan's gitweb-theme:

Mount the theme files somewhere:

services:
  gitweb:
  ...
    volumes:
      - /path/to/theme/folder:/usr/share/gitweb/theme:ro

Add the relevant lines on your gitweb.conf file:

our @stylesheets = "theme/gitweb.css";
our $logo = "theme/git-logo.png";
our $favicon = "theme/git-favicon.png";

Tags and Variants

This image uses the stable, Alpine-based Nginx Docker image.

'X.Y-bZ': Immutable tag. Points to a specific image build and will
not be reused.
'X.Y': Stable tag for specific Git major and minor versions. It
follows the latest build for Git version X.Y and therefore changes
on every patch change (i.e. 1.2.3 to 1.2.4), on every change on
Nginx and every change on the base Alpine image.
'latest': This tag follows the very latest build regardless any
major/minor versions.

License

View license information for the software contained in this
image.

As with all Docker images, these likely also contain other software
which may be under other licenses (such as git, etc from the base
distribution, along with any direct or indirect dependencies of the
primary software being contained).

As for any pre-built image usage, it is the image user's
responsibility to ensure that any use of this image complies with any
relevant licenses for all software contained within.

Credits

This image is heavily inspired by Kostya's gitweb-readonly but
simpler and lighter.

GitWeb configuration hints thanks to Arch's Wiki.

rockstorm101/gitweb-docker