# legit

> Open-source, self-hosted browsing UI for Git repos, built in Go: serves bare repositories from a folder with custom templates, README rendering and HTTP cloning.

- **Category:** Code Hosting
- **Licence:** MIT
- **Latest version:** v0.2.4
- **Open source:** oss
- **Languages:** Go, HTML
- **Platforms:** Docker, Go
- **Tags:** Git, Go, Syntax highlighting, Code hosting, Ghcr, Web Frontend, YAML Config, Chroma, Repository Browser, Bare Repos

## Description

legit is a small web UI for Git repositories, implemented in Go, aimed at people who keep their repos on their own server and want a clean way to browse them. It scans a directory of repositories, renders each repo's readme with a selectable chroma syntax theme, supports cloning over HTTP(S), and lets you fully override the shipped templates and static styling. Entries in the ignore or unlisted config lists stay hidden from the site. Install it by cloning the source and building with go, or pull the ghcr.io/icyphox/legit container image; configure it with a yaml file (config.yaml in the working directory, or a path given via --config) and run it behind a TLS-terminating proxy such as nginx or relayd. Notable limits: cloning works only for bare repositories, HTTPS push is implemented but switched off by default since authentication is fiddly (SSH is recommended), and subdirectories under the scan path are not traversed.

## Links

- [Homepage](https://github.com/icyphox/legit)
- [Website](https://git.icyphox.sh)
- [Docker](ghcr.io/icyphox/legit)
- [Source repository](https://github.com/icyphox/legit)
- [Container package](https://github.com/icyphox/legit/pkgs/container/legit)

---
Source: https://selfhost.directory/project/legit