Article version: GitHub.com
Versioning large files
Git Large File Storage (Git LFS) is an open source extension to Git that allows you to work with large files the same way as other text files.
About Git Large File Storageโ
Git LFS lets you push files to GitHub that are larger than the Git push limit.
Installing Git Large File Storageโ
In order to use Git LFS, you'll need to download and install a new program that's separate from Git.
Configuring Git Large File Storageโ
Once Git LFS is installed, you need to associate it with a large file in your repository.
About storage and bandwidth usageโ
Every account using Git Large File Storage receives 1 GB of free storage and 1 GB a month of free bandwidth. If the bandwidth and storage quotas are not enough, you can choose to purchase an additional quota for Git LFS.
Collaboration with Git Large File Storageโ
With Git LFS enabled, you'll be able to fetch, modify, and push large files just as you would expect with any file that Git manages. However, a user that doesn't have Git LFS will experience a different workflow.
Moving a file in your repository to Git Large File Storageโ
If you've set up Git LFS, and you have an existing file in your repository that needs to be tracked in Git LFS, you need to first remove it from your repository.
Removing files from Git Large File Storageโ
If you've set up Git LFS for your repository, you can remove all files or a subset of files from Git LFS.
Resolving Git Large File Storage upload failuresโ
If your Git LFS files didn't upload properly, you can take several steps to troubleshoot the upload error.