User guide

Rgit is Git with etiquette. Rabun Git is a git forge you run on a machine you own: SSH remotes, users and roles, merge requests, a small CI runner, and Conventional Commits / SemVer 2.0 by default (how to turn that off). There is no website on the forge host. To read a tree in a browser, use rgit view on this machine.

If you know git clone, git commit, and git push, start at the top and follow the pages in order. Each page has copy-paste examples (git.example.com, user ada, repo ada/website).

Contents

1. What is Rabun Git? — how this compares to GitHub and a plain git remote
2. Install — build the rabun-git command
3. Start the forge — pack-and-push or manual init / serve, then first admin and key
4. Set up a remote repository — create owner/name, add origin, first push or clone
5. Users and roles — add people, register keys, grant and revoke read / write / admin
6. Everyday git — clone, branches, protected main / master, local rgit view
7. Merge requests — propose, review, fast-forward merge
8. CI workflows — .rabun/workflows on push, tag, and request
9. Versioning — SemVer, Conventional Commits, changelog, rgit version
10. Command reference — CLI and SSH cheat sheet
11. Compared to GitHub — feature and gh command gap analysis

Operators who need on-disk layout, ACL internals, or systemd: architecture. Ubuntu pack/push: deploy Ubuntu.

Two jobs you will do

Clone URL shape used throughout:

ssh://git@git.example.com:2222/ada/website.git

Forge commands from this machine (key copy registers the first admin key over host SSH):

rgit remote add origin git@git.example.com
rgit origin key copy ada --admin
rgit origin repo list