Gemigit

A software forge for the gemini protocol

Features

• Allow users to create and manage git repositories
• Private and public repositories
• Serving git repositories on the http and ssh protocols
• LDAP authentication
• 2FA with time-based one-time passwords
• Option to use token authentication when doing git operations
• Basic brute-force protection
• User groups
• Privilege system for read/write access
• Support for sqlite and mysql databases
• Support stateless mode for multiple instances and load balancing

Requirements

• go (at compile-time)
• git (at run-time)
• openssl (to create certificate)

Fedora, RedHat

dnf install git golang openssl

Debian, Ubuntu

apt install git golang openssl

Setup

• Build the program with the following command :

go build

• Copy config.yaml into either /etc/gemigit, /usr/local/etc/gemigit or the working directory where Gemigit will be executed
• Create a new certificate with the following command, you can change localhost to the domain name you want to use :

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 365 -nodes -subj '/CN=localhost'

• Edit the configuration file as you want
• Execute gemigit

On Linux, Gemigit can be run as a systemd service :

adduser -d /var/lib/gemigit -m -U gemigit
cp service/gemigit.service /etc/systemd/system/
go build
cp gemigit /usr/bin/gemigit
mkdir /etc/gemigit
cp config.yaml /etc/gemigit/
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 365 -nodes -subj '/CN=localhost'
cp *.pem /var/lib/gemigit/
chown -R gemigit:gemigit /var/lib/gemigit
systemctl enable --now gemigit

Demo

You can try a public instance of Gemigit at this address gemini://gmi.rmf-dev.com using a Gemini client or with a gemini web proxy.

Contact

For inquiries about this software or the instance running at gemini://gmi.rmf-dev.com, you can contact the main maintainer of this project at : [email protected]