Managing large files

GitHub limits the size of files you can track in regular Git repositories. Learn how to track or remove files that are beyond the limit.

GitHub limits the size of files allowed in repositories. To track files beyond this limit, you can use 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.

Once Git LFS is installed, you need to associate it with a large file in your repository.

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.

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.

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.

If you've set up Git LFS for your repository, you can remove all files or a subset of files from Git LFS.

If your Git LFS files didn't upload properly, you can take several steps to troubleshoot the upload error.