Git Granary is a Git Large File Storage (LFS) server implementation written in TypeScript (sorry).
Git Granary was designed for self-hosted personal use. See my introduction blog post.
Basic HTTP authentication is used for initial requests. Running behind a HTTPS proxy like Caddy or Traefik is strongly recommended. Short-lived single use tokens are generated for each download & upload operation.
Basic auth username and password are configured using GGLFS_USERNAME and GGLFS_PASSWORD environment variables.
For HTTPS reverse proxies set GGLFS_ORIGIN to a full URL, e.g. https://lfs.example.com. If defined the server will only respond to proxies that set x-forwarded headers.
See .env.example for all config options.
Git clients can be configured with .lfsconfig:
[lfs]
url = http://user:pass@localhost:8000/repoOr git config command:
git config lfs.url 'http://user:pass@localhost:8000/repo'See the Git LFS documentation for full client configuration.
Git Granary is coded with cross-runtime JavaScript where possible. Adapters are used for runtime specific APIs like filesystem access and HTTP servers.
Deno is the primary full featured implementation. Bun and Node adapters are minimum viable implementations.
No Windows support because the server assumes posix paths. It might run under WSL. I don't know, I don't care.
No affordances are made for Git clients that fail to conform to the specification.
MIT License | Copyright © 2024 David Bushell