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 store files up to 2 GB in size.

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 properly, you can take several steps to troubleshoot the upload error.

Ask a human

Can't find what you're looking for?

Contact us