Legacy Knowledge Base
Published Jun. 30, 2025

Large files (20MB+) on Git repository become corrupted when deploying to Cloud

Written By

Gustavo Vasconcelos

How To articles are not official guidelines or officially supporteddocumentation. They are community-contributed content and may not alwaysreflect the latest updates to Liferay DXP. We welcome your feedback toimprove How to articles!

While we make every effort to ensure this Knowledge Base is accurate, itmay not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with anyfeedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack"publication program, made available for informational purposes. Articlesin this program were published without a requirement for independentediting or verification and are provided "as is" withoutguarantee.

Before using any information from this article, independently verify itssuitability for your situation and project.
Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM).

NOTE: This article is an INTERNAL article and is not visible to customers, currently. Please only link this article in internal comments, but not public comments.

Issue

  • [IMPORTANT] Please be advised that there are scenarios where deleting .gitattributes could cause further issues. This article was changed to internal instead, given that this solution has worked with at least one customer before.
  • When deploying large files (above 20MB in size), the files become corrupted and have only a few hundred kilobytes instead.
  • This happens for Liferay-provided hotfixes as well.

Environment

  • Any DXP
  • Liferay PaaS
  • Git repository with Git LFS (Large File Storage) enabled.

Resolution

  • Liferay Cloud CI service (Jenkins) has built-in support for Git LFS since version 4.0.2.
  • Some tools require a configuration file in order to work correctly with Git LFS: .gitattributes.
  • This file is not needed by out CI service, and will, in fact, cause our OOTB integration to Git LFS to fail.
  • In order to be able to deploy large files to Liferay Cloud, please delete the .gitattributes file from your repository's root directory and commit the changes.

 

Additional Information

 

Did this article resolve your issue ?

Legacy Knowledge Base