cgit material docker

Dockerized cgit with a responsive Material Design theme.

Quick Start

Run the container using the following command:

docker run -d -p 80:80 igorechek06/cgit-material

Configuration and Volumes

You can map local directories to the following paths inside the container to customize the instance.

/app/repos/

This is the recommended directory to store your git repositories.

/app/www/static/

Used for storing static assets such as images.

• Note: When referencing these files in cgitrc, write the path relative to /app/www/.

/app/about/

Used to store specific Markdown files for repository descriptions.

• Usage: Set repo.readme=/app/about/filename.md in your config.

/app/etc/cgitrc and /app/etc/

The main configuration file. It follows the standard cgitrc syntax.

/app/include/

Contains HTML fragments included in the pages.

• head.html: Used by the head-include setting.
• You can also place files here for the header or footer settings defined in cgitrc.

/app/filters/

Contains the original cgit filters and two custom filters required for the Material theme. You can add your own custom filter scripts to this directory.

/app/www/css/

Contains files for markdown syntax highlighting and color variables. (See www/css folder)

Examples

Configuration examples are located in the /examples directory. This includes the configuration used for git.igorek.dev.