Thunderforge
Thunderforge

Reputation: 20595

How large does a "large file" have to be to benefit from Git LFS?

I'm reading about Git LFS and see time and again that it works great for "large files"

Git Large File Storage (LFS) replaces large files such as audio samples, videos[...]

Version large files—even those as large as a couple GB in size—with Git.

Git Large File Storage (LFS) is a free, open-source extension that replaces large files with text pointers inside Git and stores the contents of those files on a remote server.

Unfortunately, I don't see anywhere what a "large file" actually is. It's clear that something that takes up several gigabytes is a large file, but what about something smaller?

Will I benefit from Git LFS with "large files" as small as 50 MB? 20MB? 5MB? 1MB? Less than 1MB?

How large does a "large file" have to be to benefit from Git LFS compared to regular Git?

Upvotes: 66

Views: 29024

Answers (3)

IMSoP
IMSoP

Reputation: 97968

Most version control systems are optimised for "small-ish text files". Storing a 100MB file in any VCS will take up at least 100MB of file system somewhere (assuming it can't easily be compressed). If you store 3 completely different versions, that's 300MB of storage somewhere.

The difference with distributed version control systems, such as git, is that they include the full history in every working copy. That means every version of every file takes up space in every working copy, forever, even if the file is deleted in a later revision. (On a centralised VCS, this space would only be spent on the central server.)

There is however a bright side: git is quite smart about how it stores things, at two levels of abstraction:

  • At one level, git is a "content-addressed database": it stores "blobs" based on a hash of their content. That means that a file needs a new blob only when its content changes; and in fact, only when that content has never occurred before in the entire history of the repository.
  • At the next level down, even that "blob" may not be stored in full on the file system, because a packfile may include it as a delta (a set of changes) from a similar blob.

That leads to a few considerations of when LFS, or some other out-of-repo solution, might be useful:

  • How big is the file? If it's a few megabytes, that may be enough on its own to not include it in history.
  • How frequently does it change? A 100KB file re-generated with random content on every commit would add a megabyte to every working copy for every 10 commits.
  • Is every version actually different? If you have two different versions of a logo, and you keep changing your mind which to use, it won't take up any extra space as long as you use exactly the same two files. The same applies to renaming a file: if the content is unchanged, no extra "blob" is needed.
  • How different are the versions, from a binary point of view? If you keep appending to a very long log file, git will probably notice and store it in a relatively efficient packfile.

Upvotes: 5

yamenk
yamenk

Reputation: 51886

There is no exact threshold to define what is a large file. This is up to the user. To see if you need to store some files using Git LFS you need to understand how git works.

The most fundamental difference between Git and other source control tools (perforce, svn), is that Git stores a full snapshot of the repository on every commit. Thus when you have a large file, the snapshot contains a compressed version of this file (or a pointer to the file blob if the file wasn't changed). The repository snapshot is stored as a graph under the .git folder. Thus if the file is "large", the repository size will grow rapidly.

There are multiple criteria to determine whether to store a file using Git LFS.

  • The size of the file. IMO if a file is more than 10 MB, you should consider storing it in Git LFS

  • How often the file is modified. A large file (based on the users intuition of a large file) that changes very often should be stored using Git LFS

  • The type of the file. A non-text file that cannot be merged is elligible for Git LFS storage

Will I benefit from Git LFS with "large files" as small as 50 MB? 20MB? 5MB? 1MB? Less than 1MB?

Depending on how often the file changes, in any size mentioned you can benefit. Consider the case where you do 100 commits editing the file every time. For a 20MB file that can be compressed say to 15 MB, the repository size would increase by approximately 1.5GB if the file is not stored using Git LFS.

Upvotes: 52

Bonje Fir
Bonje Fir

Reputation: 840

LFS is a tool for maintenance of resources of projects. Suppose you have a project which has *.psd files which used in Front-end. These files are usually large and the versioning of a file is not respect to previous versions(git saves history of changes for text files in commits but for binary files this approach could not be used. diff of two .cpp files has meaning but diff of two raw photo does not.). So if you put resources to repository its size and cloning time will be growth unsightly. Moreover maintenace will be hard.

How can overcome this issue? First of all one good idea is that to split database of large files from codes in server-side. Another is that the clients allowed to pull part of them which they want to use currently on his/her local machine(i.e not all of previous files).

What LFS does? It hash its tracked files and store theme as a pointers to original files. Store original files to separate database on server-side. Local repositories have all of pointers in their history but when you checkout a specific commit, it pull just its contents. The size of local repository and time of clone will decreases impressively in this manner.

PS: The method of receiving files in lfs is differ from git. So I think it uses some technics to split large files, send them in different parallel connections and and merge them... and such stuff which can improve its functionality... But what is important is that it can increase time of clone/pull for hundred/thousands of small files.

Also note that git has problem with files larger that 4GB in windows.

Upvotes: -4

Related Questions