This code is a hard fork of https://github.com/icyphox/legit. Various bugs are fixed and templates (HTML/CSS/JS) are completely different. New features are opt-in, so you can use a config file from the upstream in this fork.

Features #

Repository browsing; commits, refs, tree, etc.
Simple deployment; single binary without CGI.
Supports gitweb-compatible description and category.
Secure readonly file access with unveil(2) (OpenBSD) and Landlock (Linux).

Requirements #

Supports Linux and OpenBSD. Probably runs on other UNIX-y systems as well, but lacks important security features.
Put TLS terminating proxy such as reverse proxy or CDN in front of legit.

Quick Start #

Clone this repository and run go run . on the worktree. You need Go toolchain >= v1.25.0 to run go commands.

go run . -repo.scanPath demo

See docs/INSTALL.md for more info.

Configuration #

legit reads YAML config file. Create YAML file somewhere (e.g. $XDG_CONFIG_HOME/legit/config.yaml) and pass the path to legit via --config flag. See the sample config.yaml for more info.

Bug Reports #

If you find a bug in this software, please report it on https://tangled.org/pocka.jp/legit/issues.

License #

This software is licensed under MIT. See license for license text.

Newly added files have REUSE compliant comment headers for easier per-file use.