New size limits for Git repositories and files [Starting September 2020]

Hi Backlog users!

Starting in September 2020, there will be size limits for Git repositories and files.

Why we’re creating size limits for Git:

Git isn’t that great at managing large files , such as audio, video, or high-quality images. The more large files in your repository, the slower it is for regular Git processes like git clone, git push or git pull. 

In order to provide performance and a stable service for our users, we’ve decided to set these limits:

  • Maximum file size is 100 MB
  • Maximum repository size is 10 GB

If the size of a file exceeds 100 MB, you will receive an error message and the push will be blocked.

The total repository size limit is 10 GB. There will be warning messages as your repository size approaches the limit. If it exceeds the limit, you will receive an error message and the push will be blocked.


What if you already exceed the limit?

If an existing repository already exceeds the new limit, we will reach out to you via email about reducing it.

For now, repositories created before September 2020 that exceed the new repository limits will remain available. But we will likely require them to fit these new limits in the foreseeable future.


Things you can do to reduce file and repository sizes

If you are regularly pushing files of 100MB or more

Files that have already been pushed will still be available for download after this limit is applied. But you won’t be able to push those files anymore. Luckily, there are a few helpful solutions for reducing files sizes in Backlog:

  • Git LFS lets you easily push files larger than 100MB to your Git repository. Read more about how to use it in this help article.
  • Project Shared Files lets you continue to manage files larger than 100 MB. Read more about how to use it in this help article.

Note:  Shared File doesn’t maintain versions like Git.


If your repository size is about to reach 10GB

After applying this limit, any pushes that exceed 10 GB in repository size will be blocked. If your repository size is about to reach 10GB, you should remove large files from the repository to reduce the size of your repository.

Note:  You cannot reduce repository size by simply deleting a large file from the latest commit. The files from past commits exist in the repository as a snapshot. That means you’ll have to go back and delete files from past commits, too.


Thank you for working with us on this change

We understand that some users will need to dedicate a bit of time to reduce their repositories and put in place new ways of managing larger files. We apologize for any inconvenience this may cause.

We look forward to bringing you a faster, more stable Backlog with these size limits in place. And we appreciate your understanding greatly.