# cgithub

A GitHub-like theme for cgit.

Fork of: [https://www.hackitu.de/cgithub/](https://www.hackitu.de/cgithub/)

## Installation

### Build from source

1. `cd` into source directory where `Dockerfile` resides.
2. Run `docker buildx build --pull -t cgithub:latest .` to build the image and tag it as `cgithub:latest`.
3. Run the image as container:
```bash
docker run --rm \
    --read-only -v /media/mnt/vcs/git:/mnt:ro --tmpfs /tmp:size=10%,mode=1777,rw,noatime,noexec,nosuid,nodev \
    --user $(id -u www-data):$(getent group git | cut -d: -f3) --security-opt=no-new-privileges:true --cap-drop=all \
    --network=host -e APACHE_PORT=8080 --name cgit cgithub:latest
```

### Run as docker compose

1. `cd` into directory where `docker-compose.yml` resides.
2. Adjust `docker-compose.yml` to your liking.
3. Run `docker compose up -d` to run the container.

### Run directly

```bash
docker run --rm \
    --read-only -v /media/mnt/vcs/git:/mnt:ro --tmpfs /tmp:size=10%,mode=1777,rw,noatime,noexec,nosuid,nodev \
    --user $(id -u www-data):$(getent group git | cut -d: -f3) --security-opt=no-new-privileges:true --cap-drop=all \
    --network=host -e APACHE_PORT=8080 --name cgit lionheart1810/cgithub:latest
```

## References

- [Original guide](https://www.hackitu.de/cgithub/)