Upcoming changes to Bitbucket Git LFS

[#1]

Starting on January 27, 2025, your Git Large File Storage (LFS) client will communicate directly with file storage in Amazon Web Services (AWS) S3. While this change helps to optimize file management, it also affects the upload file size limit and may require some updates to your IP- or URL-based allowlist.

New 5 GB limit to an individual Git LFS file size upload

AWS S3 limits the size of an object that can be uploaded with a single PUT request to 5 GB. Uploading files larger than 5 GB will result in a validation error. This change does not affect already uploaded objects with sizes exceeding the new limit, and you will still be able to download existing objects.

Options for files exceeding 5 GB

1. Split large files: Consider splitting files larger than 5 GB into smaller segments.

2. Use compression: Where possible, compress large files before uploading. This may reduce file sizes to below the 5 GB limit.

Future improvements

The current Git LFS specification does not support a multi-part upload protocol. We encourage users to voice their support for this feature in the Git LFS community to help prioritize its development.

How to find files exceeding 5 GB in your repository

Navigate to Repository settings > Git LFS page and click on the Size column to sort files by size.

The list of repositories with Git LFS enabled can be viewed on Workspace settings > Git LFS page.

Changes to IP Allowlisting

If you use IP- or URL-based allowlisting to manage traffic to and from your network infrastructure, be aware that the Git LFS clients will now communicate directly with file storage in AWS S3. Please ensure that you allowlist the IP addresses linked below for both incoming and outgoing traffic in your corporate firewall:

Option to continue using IP-based allowlisting

An exhaustive list of IP addresses that traffic can go to via AWS can be found by using the following endpoint, filtering to records where the service equals S3, and using the us-east-1 and us-west-1 regions.

Option to continue using URLs for allowlisting

Please allowlist the following URL:

micros--prod-west--bitbucketci-file-service--git-lfs-files.s3.us-west-1.amazonaws.com

---

If you need help, customers on paid plans can reach out directly to our Support team. Any customers on a free plan, can request help via the Bitbucket space in Atlassian Community.