👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.
Article version: GitHub.com

Distributing large binaries

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

Were you able to find what you were looking for?

If you need to distribute large files within your repository, you can create releases on GitHub. Releases allow you to package software, release notes, and links to binary files, for other people to use. For more information, visit "About releases."

We don't limit the total size of the binary files in the release or the bandwidth used to deliver them. However, each individual file must be smaller than 2 GB.

Tip: If you regularly push large files to GitHub, consider using Git Large File Storage (Git LFS). For more information, see "Versioning large files."

Were you able to find what you were looking for?

Ask a human

Can't find what you're looking for?

Contact us