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
212grant on that repo: =repo access grant <owner/name> ci write=. Private 212grant on that repo: =repo access grant <owner/name> ci write=. Private
213repos likewise need at least read for the clone. 213repos likewise need at least read for the clone.
214 214
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
215* Pages 225* Pages
216 226
217=[pages] domain = "example.site"= serves public repos' =pages= branches 227=[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
333mutually exclusive. =build trigger <owner/name> <job>= queues any job 333mutually exclusive. =build trigger <owner/name> <job>= queues any job
334immediately. 334immediately.
335 335
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
336* Pages 345* Pages
337 346
338On instances with =[pages] domain= set, a =pages= branch in any public 347On instances with =[pages] domain= set, a =pages= branch in any public