Commit b47ac9b55a

b47ac9b55a36a1fd15d636d2c918ade886adfe55

parent: 53771042a4

Verified · cmc

cmc <hello@cleberg.net> · 2026-08-25 21:05 UTC

docs: LFS usage and storage

Layout: unified · split

Admin.org +10
@@ -212,6 +212,16 @@ deploy, an archive publish, an automated MR branch — needs an explicit
212212grant on that repo: =repo access grant <owner/name> ci write=. Private
213213repos likewise need at least read for the clone.
214214
215* LFS storage
216
217Objects live content-addressed under =[lfs] root= (default
218=<server.root>/lfs=); =[lfs] max_object_bytes= caps a single object
219(512MB default). Storage sits behind a small interface — an
220S3-compatible backend is a drop-in with the server proxying, and
221presigned URLs a later optimization. LFS objects do not travel with
222push mirrors (mirrors move git refs only), and gc does not yet collect
223orphaned objects.
224
215225* Pages
216226
217227=[pages] domain = "example.site"= serves public repos' =pages= branches
Users.org +9
@@ -333,6 +333,15 @@ matching tag is pushed — and only then; =schedule= and =tags= are
333333mutually exclusive. =build trigger <owner/name> <job>= queues any job
334334immediately.
335335
336* Large files (LFS)
337
338Standard Git LFS works over both transports with no setup beyond the
339usual =git lfs track=. SSH remotes authenticate through
340=git-lfs-authenticate= (deploy keys included: ro keys can download, rw
341keys upload); anonymous HTTPS clones of public repositories can fetch
342LFS objects with no credentials. Objects are verified against their
343sha256 on upload and capped at 512MB by default.
344
336345* Pages
337346
338347On instances with =[pages] domain= set, a =pages= branch in any public