From 3561b6d86c329272b1825adaf3ca49c9aff76119 Mon Sep 17 00:00:00 2001 From: Thomas Vanbesien Date: Thu, 12 Feb 2026 21:24:22 +0100 Subject: Refactor - Remove cgit files; pull cgit image from Docker Hub instead of building locally - Tidy up file hierarchy - Minor fixes and edits --- services/cgit/readme.md | 73 ------------------------------------------------- 1 file changed, 73 deletions(-) delete mode 100644 services/cgit/readme.md (limited to 'services/cgit/readme.md') diff --git a/services/cgit/readme.md b/services/cgit/readme.md deleted file mode 100644 index bef4b9b..0000000 --- a/services/cgit/readme.md +++ /dev/null @@ -1,73 +0,0 @@ -# cgit - -This project is a [cgit](https://git.zx2c4.com/cgit/about/) docker image. - -It aims to be as simple as possible. No authentication, no SSH, just browsing repositories on a web page. The container doesn't write to the repositories so they can be read-only. - -# Build - -``` -docker build --tag cgit . -``` - -# Run - -## cgit configuration and runtime - -Examples are provided in the `examples` directory. - -* `CGITRC`: Host directory containing a `cgitrc` configuration, see [cgitrc manual](https://manpages.debian.org/trixie/cgit/cgitrc.5.en.html). -* `COMMIT_FILTER`: Host directory containing an executable `commit-filter.sh` script to format Git commit messages. See the `commit-filter` section of the [cgitrc manual](https://manpages.debian.org/trixie/cgit/cgitrc.5.en.html). -* `ABOUT`: Host directory containing `about.md` for the front page "about" section. -* `REPOSITORIES`: Host directory containing your Git repositories. - -## Run with `docker` - -``` -docker run \ - --rm \ - --name cgit \ - --publish 8080:80 \ - --mount type=bind,src=CGITRC,dst=/etc/cgit,ro \ - --mount type=bind,src=COMMIT_FILTER,dst=/usr/local/lib/cgit/filters/commit \ - --mount type=bind,src=ABOUT,dst=/srv/cgit,ro \ - --mount type=bind,src=REPOSITORIES,dst=/srv/git,ro \ - cgit -``` - -Browse the website [here](http://localhost:8080). - -## Run with `docker compose` - -*Example `compose.yaml`:* - -``` -services: - cgit: - build: . - image: cgit - container_name: cgit - ports: - - 8080:80 - volumes: - - CGITRC:/etc/cgit:ro - - COMMIT_FILTER:/usr/local/lib/cgit/filters/commit - - ABOUT:/srv/cgit:ro - - REPOSITORIES:/srv/git:ro -``` - -Browse the website [here](http://localhost:8080). - -# Configuration - -## Repository specific `cgitrc` - -Add a `cgitrc` file at the root of a repository to configure it for cgit. Note that this only works with the `scan-path` setting. - -*Example `cgitrc`:* - -``` -desc=Repository description -owner=Repository owner -section=Repository section -``` -- cgit v1.2.3