# Support Git LFS.

**URL:** https://discussions.unity.com/t/support-git-lfs/610787
**Category:** Build Automation
**Tags:** Unity-Build-Automation
**Created:** [December 30, 2015, 11:42am UTC](https://discussions.unity.com/t/support-git-lfs/610787 "2015-12-30T11:42:46Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![techmage](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/techmage/32/951432_2.png) [@techmage](https://discussions.unity.com/u/techmage)
#### Post date: [December 30, 2015, 11:42am UTC](https://discussions.unity.com/t/support-git-lfs/610787/1 "2015-12-30T11:42:46Z")

</div>

> **[Git Large File Storage](https://git-lfs.com/)**
>
> Git Large File Storage (LFS) replaces large files such as audio samples, videos, datasets, and graphics with text pointers inside Git, while storing the file contents on a remote server like GitHub.com or GitHub Enterprise.

I think it’s really important to get support for this in place. Both Github and Gitlab support it now. I’ve been hosting all my development on Github with it. So I can’t use Cloud Build without it.

It’s also super easy to install…

---

<div class="post-metadata">

### Author: ![unitychrism](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/unitychrism/32/139845_2.png) [@unitychrism](https://discussions.unity.com/u/unitychrism)
#### Post date: [January 4, 2016, 6:01pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/2 "2016-01-04T18:01:26Z")

</div>

Hi there,

This is something that’s definitely on our radar, and while there is currently no ETA you are correct in that it’s pretty straightforward to install. Once we have built support for LFS into our infrastructure, I’ll be sure to post an update here to alert you and everyone to its availability. In the meantime, for anyone else looking for LFS support, please post a vote at our feedback site as it helps our team gauge demand for new feature requests from the community:

[https://feedback.unity3d.com/suggestions/git-lfs-large-file-support-for-unity-cloud-build](https://feedback.unity3d.com/suggestions/git-lfs-large-file-support-for-unity-cloud-build)

Stay tuned!

Regards,  
-Chris

---

<div class="post-metadata">

### Author: ![RJS](https://avatars.discourse-cdn.com/v4/letter/r/ea5d25/32.png) [@RJS](https://discussions.unity.com/u/RJS)
#### Post date: [February 4, 2016, 1:19am UTC](https://discussions.unity.com/t/support-git-lfs/610787/3 "2016-02-04T01:19:42Z")

</div>

This issue is clearly the most voted suggestion that the Cloud Build team has in the feedback system. Given this and your suggestion that it’s straightforward to implement, why is there no ETA or roadmap item?

---

<div class="post-metadata">

### Author: ![Ash-Blue](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/ash-blue/32/44233_2.png) [@Ash-Blue](https://discussions.unity.com/u/Ash-Blue)
#### Post date: [March 6, 2016, 6:44am UTC](https://discussions.unity.com/t/support-git-lfs/610787/4 "2016-03-06T06:44:49Z")

</div>

Our team can’t use Cloud Build without Git LFS. Would absolutely love for you guys to add this feature.

---

<div class="post-metadata">

### Author: ![GalxyzStudios](https://avatars.discourse-cdn.com/v4/letter/g/85e7bf/32.png) [@GalxyzStudios](https://discussions.unity.com/u/GalxyzStudios)
#### Post date: [March 11, 2016, 11:20pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/5 "2016-03-11T23:20:16Z")

</div>

Any updates on this? Relatively simple to implement and a lot of us here are waiting for this, sounds like it should be a feature pushed out on a very high priority. Any timeline?

---

<div class="post-metadata">

### Author: ![unitychrism](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/unitychrism/32/139845_2.png) [@unitychrism](https://discussions.unity.com/u/unitychrism)
#### Post date: [March 15, 2016, 7:50pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/6 "2016-03-15T19:50:39Z")

</div>

Hey all,

We’ve been actively working on Git LFS support, as it’s the highest rated item for Cloud Build on the Feedback site. Some early experiments are showing promising results, so right now it’s possible that your LFS-enabled project will work. If you do give it a try, please reach out and let us know how it goes. Keep in mind that LFS is not technically supported right now, so this is targeted more at existing users of LFS that are comfortable with it.

Some basic guidelines:

- You must have SSH access to your projects at an account level (GitLab doesn’t currently support SSH authentication with LFS).
- Deployment keys are not supported on GitHub.

---

<div class="post-metadata">

### Author: ![bryantdrewjones](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/bryantdrewjones/32/580692_2.png) [@bryantdrewjones](https://discussions.unity.com/u/bryantdrewjones)
#### Post date: [April 2, 2016, 3:31am UTC](https://discussions.unity.com/t/support-git-lfs/610787/7 "2016-04-02T03:31:38Z")

</div>

Hi @unitychrism🙂

Just reporting in to confirm that whatever early experiments you’re doing are working for our project! 🙂 Thanks for adding in LFS support so quickly! 🙂

---

<div class="post-metadata">

### Author: ![unitychrism](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/unitychrism/32/139845_2.png) [@unitychrism](https://discussions.unity.com/u/unitychrism)
#### Post date: [April 4, 2016, 6:14pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/8 "2016-04-04T18:14:32Z")

</div>

Yes, positive feedback! 🙂 Glad to hear it, and would appreciate feedback from any others that configure their LFS project in Cloud Build. There should be more information available in the near future, which I will also link to here.

---

<div class="post-metadata">

### Author: ![bryantdrewjones](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/bryantdrewjones/32/580692_2.png) [@bryantdrewjones](https://discussions.unity.com/u/bryantdrewjones)
#### Post date: [April 6, 2016, 6:40am UTC](https://discussions.unity.com/t/support-git-lfs/610787/9 "2016-04-06T06:40:42Z")

</div>

Hello again @unitychrism🙂

We got an LFS-specific error in our latest Cloud Build. It’s complaining about a file that it had no trouble with in the past, which is weird. Here’s the relevant portion of the log:

> [@](#):
>
> ERROR: Error cloning remote repo ‘origin’  
> Error downloading object: Assets/Tools/Water FX Pack/Textures/FX\_waterfall4.tga (28e6e7572ea4173b32cfe9cff2816a950a39cdff63d4ac5ded9a9e1f60c8f4e1)  
> Errors logged to /BUILD\_PATH/artbit.dark-game.default-mac-desktop-64-bit/.git/lfs/objects/logs/20160406T012201.843811653.log  
> error: external filter git-lfs smudge %f failed 2  
> error: external filter git-lfs smudge %f failed  
> warning: Clone succeeded, but checkout failed.  
> ERROR: Could not clone repository  
> Caused by: [java.io](http://java.io/).IOException: Could not clone

The Cloud Build system took just over 50 minutes before hitting that error. I’m attempting a new build right now just to see if it can recover on its own. I wonder if it just doesn’t like how many assets we have stored via LFS?

Edit: Just for reference, here’s our .gitattributes file:

> [@](#):
>
> \*.psd filter=lfs diff=lfs merge=lfs -text  
> \*.png filter=lfs diff=lfs merge=lfs -text  
> \*.jpg filter=lfs diff=lfs merge=lfs -text  
> \*.zip filter=lfs diff=lfs merge=lfs -text  
> \*.ai filter=lfs diff=lfs merge=lfs -text  
> \*.fla filter=lfs diff=lfs merge=lfs -text  
> \*.swf filter=lfs diff=lfs merge=lfs -text  
> \*.wav filter=lfs diff=lfs merge=lfs -text  
> \*.mp3 filter=lfs diff=lfs merge=lfs -text  
> \*.ogg filter=lfs diff=lfs merge=lfs -text  
> \*.mp4 filter=lfs diff=lfs merge=lfs -text  
> \*.tga filter=lfs diff=lfs merge=lfs -text

---

<div class="post-metadata">

### Author: ![bryantdrewjones](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/bryantdrewjones/32/580692_2.png) [@bryantdrewjones](https://discussions.unity.com/u/bryantdrewjones)
#### Post date: [April 6, 2016, 8:19am UTC](https://discussions.unity.com/t/support-git-lfs/610787/10 "2016-04-06T08:19:54Z")

</div>

Second attempt at a build failed, as well ☹ But on a different file this time.

> [@](#):
>
> ERROR: Error cloning remote repo ‘origin’  
> Error downloading object: Assets/Art (Alpha)/@4x/Scene\_Train\_Assets/Scene\_Train\_Train.png (684abe86f6cec01d7d9819d05b8f98a84f76c16048e27caaa3e089b9c2674f0b)  
> Errors logged to /BUILD\_PATH/artbit.dark-game.default-mac-desktop-64-bit/.git/lfs/objects/logs/20160406T022534.590862091.log  
> error: external filter git-lfs smudge %f failed 2  
> error: external filter git-lfs smudge %f failed  
> warning: Clone succeeded, but checkout failed.  
> ERROR: Could not clone repository  
> Caused by: [java.io](http://java.io/).IOException: Could not clone

Is there anything we can do to workaround this? ☹

---

<div class="post-metadata">

### Author: ![unitychrism](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/unitychrism/32/139845_2.png) [@unitychrism](https://discussions.unity.com/u/unitychrism)
#### Post date: [April 7, 2016, 4:33pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/11 "2016-04-07T16:33:04Z")

</div>

Hi there,

It looks like you were able to build successfully after these errors yesterday. As part of an update next week, there should be an improvement in LFS logging that will allow you to view the specific error being encountered. If this continues to happen sporadically, please let me know via direct message.

---

<div class="post-metadata">

### Author: ![bryantdrewjones](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/bryantdrewjones/32/580692_2.png) [@bryantdrewjones](https://discussions.unity.com/u/bryantdrewjones)
#### Post date: [April 7, 2016, 10:58pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/12 "2016-04-07T22:58:27Z")

</div>

Yes, third attempt (after waiting about half a day) was a success 🙂 Maybe the Cloud Build system was just having a bad night 🙂 Thanks for the reply!

---

<div class="post-metadata">

### Author: ![SureSight](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/suresight/32/90581_2.png) [@SureSight](https://discussions.unity.com/u/SureSight)
#### Post date: [April 20, 2016, 2:58am UTC](https://discussions.unity.com/t/support-git-lfs/610787/13 "2016-04-20T02:58:49Z")

</div>

I’m considering enabling LFS for our current project to take advantage of Unity Cloud Build.  
Is this officially supported yet?

---

<div class="post-metadata">

### Author: ![GalxyzStudios](https://avatars.discourse-cdn.com/v4/letter/g/85e7bf/32.png) [@GalxyzStudios](https://discussions.unity.com/u/GalxyzStudios)
#### Post date: [May 3, 2016, 12:18am UTC](https://discussions.unity.com/t/support-git-lfs/610787/14 "2016-05-03T00:18:43Z")

</div>

When will this be implemented officially? We have to move over to LFS as soon as possible.

---

<div class="post-metadata">

### Author: ![Afropenguinn](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/afropenguinn/32/537331_2.png) [@Afropenguinn](https://discussions.unity.com/u/Afropenguinn)
#### Post date: [June 29, 2016, 8:34pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/15 "2016-06-29T20:34:28Z")

</div>

Any updates on this for those of us using GitLab?

---

<div class="post-metadata">

### Author: ![DFT-Games](https://dub1.discourse-cdn.com/unity/user_avatar/discussions.unity.com/dft-games/32/88783_2.png) [@DFT-Games](https://discussions.unity.com/u/DFT-Games)
#### Post date: [June 29, 2016, 10:08pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/16 "2016-06-29T22:08:15Z")

</div>

Is that even possible to write a game without git lfs??? Repos are quite big (my current over 35GB) so it’s unclear how should we use a continuous integration that does not support that???

And you hope that I’m gonna pay a subscription?

---

<div class="post-metadata">

### Author: ![Shawn-Halwes](https://avatars.discourse-cdn.com/v4/letter/s/0ea827/32.png) [@Shawn-Halwes](https://discussions.unity.com/u/Shawn-Halwes)
#### Post date: [July 1, 2016, 5:05pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/17 "2016-07-01T17:05:03Z")

</div>

Did this ever get supported for GitHub?

---

<div class="post-metadata">

### Author: ![Shawn-Halwes](https://avatars.discourse-cdn.com/v4/letter/s/0ea827/32.png) [@Shawn-Halwes](https://discussions.unity.com/u/Shawn-Halwes)
#### Post date: [July 1, 2016, 5:07pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/18 "2016-07-01T17:07:57Z")

</div>

> [@Shawn Halwes](#):
>
> Did this ever get supported for GitHub?

NM it appears to be working, just getting some LFS related errors…

---

<div class="post-metadata">

### Author: ![Shawn-Halwes](https://avatars.discourse-cdn.com/v4/letter/s/0ea827/32.png) [@Shawn-Halwes](https://discussions.unity.com/u/Shawn-Halwes)
#### Post date: [July 1, 2016, 5:14pm UTC](https://discussions.unity.com/t/support-git-lfs/610787/19 "2016-07-01T17:14:51Z")

</div>

OK new question. Have you guys looked into updating Git and LFS?

According to my error log you are still using Git v2.6.6 and LFS v1.1.1.

There have been some LFS specific improvements with a Git v2.8.x and LFS v1.2 combination. Using it locally for a few weeks now.

Here’s an article from a SourceTree dev about some of the speed improvements:  
[https://developer.atlassian.com/blog/2016/04/git-lfs-12-clone-faster/](https://developer.atlassian.com/blog/2016/04/git-lfs-12-clone-faster/)

Using the new “git lfs clone” command would probably be a speed and stability improvement for Cloud Build.

---

<div class="post-metadata">

### Author: ![K0ZMiK](https://avatars.discourse-cdn.com/v4/letter/k/f14d63/32.png) [@K0ZMiK](https://discussions.unity.com/u/K0ZMiK)
#### Post date: [July 13, 2016, 9:18am UTC](https://discussions.unity.com/t/support-git-lfs/610787/20 "2016-07-13T09:18:34Z")

</div>

Hello,

Am I doing something wrong or Unity Cloud build and LFS is not yet operational / is experimental?

I have a Github repo with LFS, and I have have setup SSH keys.  
Previously I used Bitbucket git successully but without LFS, until I hit their 2GB hardlimit…  
Now, I tried to move to github for their LFS support, but I am stuck here…

I get a bunch of errors and a failed build

[Unity] FSBTool ERROR: The format of the source file is invalid, see output for details.  
[Unity] ImportFBX Errors:

[Unity] Updating Assets/max/Materials/BACKPACK2NORMAL.PSD - GUID: 02f73260494e6f94eb3054045a56269a…  
[Unity] Could not create texture from Assets/max/Materials/BACKPACK2NORMAL.PSD: File could not be read

Can give more details upon request…

regards

[Next page](https://discussions.unity.com/t/support-git-lfs/610787.md?page=2)
