User guide

Rgit is Git with etiquette.

Rgit is Git with etiquette. Run a git forge on a machine you own: SSH remotes, users, merge requests, a small CI runner, and Conventional Commits / SemVer 2.0 by default (turn that off). rgit serve has no HTTP git UI. Browse locally with rgit view, or add Rgit Web as a companion.

If you know git clone, git commit, and git push, follow the pages in order. Examples use 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 — install 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

Layout, ACL, systemd: architecture. Ubuntu pack/push: deploy Ubuntu. Extra disk for repos/: storage volume.

Start here

JobPage
Put a project on the forgeRemote repository
Let teammates inUsers and roles

Clone URL shape used throughout:

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

Forge commands from this machine (rgit login attaches a key after website sign-in; key copy is host SSH for the first admin):

rgit remote add origin git@git.example.com
rgit login --web https://git.example.com
rgit origin repo list