Git backed by object storage because you can't stop me
git
object-storage
kefka
docs: add README
Signed-off-by: Xe Iaso <me@xeiaso.net>
+25
+25
README.md
+25
README.md
···
1
+
# objgit
2
+
3
+
An experiment in storing git repositories in object storage. You probably don't need this. This is a proof of concept and doesn't really have a lot of uses yet.
4
+
5
+
Notable features of objgit:
6
+
7
+
- ssh, http, and git protocol support.
8
+
- [post-receive hooks](./docs/usage/hooks.md) powered by userspace sandboxed shells and [Kefka](https://xeiaso.net/blog/2026/dancing-mad-sandboxing/).
9
+
- basic prometheus metrics.
10
+
- no authentication whatsoever, if this ends up being actually useful then authentication will be implemented.
11
+
12
+
## Design tradeoffs
13
+
14
+
- All repos are stored in object storage, making the local filesystem irrelevant at the cost of making storage operations a bit more latent compared to the local filesystem.
15
+
- Post-receive hooks are stored in the repository, meaning that hooks are checked out from the repository on push.
16
+
- Right now all s3fs reads are completely buffered in memory before billy can use them, theoretically this means that the size limit for files is 2Gi.
17
+
- This is like very new and not tested in the slightest.
18
+
19
+
## Future goals
20
+
21
+
- Integration with Tekton for CI pipelines.
22
+
- Some kind of web UI using [the Xe Design System](https://design.within.website).
23
+
- Any kind of blogpost.
24
+
- Deployment to Kubernetes.
25
+
- HTTPS support with TLS termination.