Files larger than 4 GB are not correctly handled on Windows

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server and Data Center Only - This article only applies to Atlassian products on the server and data center platforms.


Files larger than 4 GB are not correctly handled on Windows.

For example:

  • after cloning a file bigger than 4GB, the downloaded file does not appear to be complete.


This is the case when using either Git core or Git LFS.



  • Windows as Operating System


This issue is caused by the following issue in the Git core project (which is not owned by the Bitbucket Server team):


When using Git LFS, smudging should be disabled completely.


Disable smudging:

$ git lfs install --skip-smudge
$ git lfs env
... snip
git config filter.lfs.process = "git-lfs filter-process --skip"
git config filter.lfs.smudge = "git-lfs smudge --skip -- %f"


Use the following to explicitly pull changes in the branches or fetch updates from the remote:

git lfs pull


Warning added in Git LFS

The following message will be added to Git client log when this issue is encountered:

Encountered <number> file(s) that may not have been copied correctly on Windows
git lfs help smudge` for more details

This has been introduced as part of this Git pull request.


Last modified on Aug 22, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.