From 1125bb5848006d1269355475553426340af62254 Mon Sep 17 00:00:00 2001 From: ᴜɴᴋɴᴡᴏɴ Date: Sun, 10 May 2020 20:37:22 +0800 Subject: lfs: add user and admin docs (#6158) --- docs/user/lfs.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 docs/user/lfs.md (limited to 'docs/user') diff --git a/docs/user/lfs.md b/docs/user/lfs.md new file mode 100644 index 00000000..f89730b6 --- /dev/null +++ b/docs/user/lfs.md @@ -0,0 +1,28 @@ +# Git Large File Storage (LFS) + +> This document is driven from https://docs.gitlab.com/ee/topics/git/lfs/. + +Managing large binaries in Git repositories is challenging, that is why Git LFS was developed for, to manage large files. + +## How it works + +Git LFS client talks with the Gogs server over HTTP/HTTPS. It uses HTTP Basic Authentication to authorize client requests. Once the request is authorized, Git LFS client receives instructions from where to fetch or where to push the large file. + +## Server configuration + +Please refer to [Configuring Git Large File Storage (LFS)](../admin/lfs.md). + +## Requirements + +- Git LFS is supported in Gogs starting with version 0.12. +- [Git LFS client](https://git-lfs.github.com/) version 1.0.1 and up. + +## Known limitations + +- When SSH is set as a remote, Git LFS objects still go through HTTP/HTTPS. +- Any Git LFS request will ask for HTTP/HTTPS credentials to be provided so a good Git credentials store is recommended. +- File locking is not supported, and is being tracked in [#6064](https://github.com/gogs/gogs/issues/6064). + +## Using Git LFS + +Git LFS endpoints in a Gogs server can be automatically discovered by the Git LFS client, therefore you do not need to configure anything upfront for using it. Please walk through official [Git LFS Tutorial](https://github.com/git-lfs/git-lfs/wiki/Tutorial) to get started. -- cgit v1.2.3