Article version: GitHub.com

Working with large files

A Git repository contains every version of every file. But for some file types, this is not practical. Multiple revisions of large files increase the clone and fetch times for other users of a repository.

Conditions for large files

GitHub will warn you when pushing files larger than 50 MB. You will not be allowed to push files larger than 100 MB.

Removing files from a repository's history

To remove a large file from your repository, you must completely remove it from your local repository and from GitHub.

Distributing large binaries

Some projects require distributing large files, such as binaries or installers, in addition to distributing source code.

What is my disk quota?

GitHub doesn't have any set disk quotas. We try to provide abundant storage for all Git repositories, within reason. Keeping repositories small ensures that our servers are fast and downloads are quick for our users.

Ask a human

Can't find what you're looking for?

Contact us