policy service_limits ai_generated true

GitHub LFS bandwidth quota exceeded — pushes and pulls fail

ID: policy/github-lfs-bandwidth-exceeded

Also available as: JSON · Markdown
80%Fix Rate
85%Confidence
4Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
any active — — —

Root Cause

GitHub LFS has 1GB storage and 1GB/month bandwidth on free plan.

generic

Workarounds

  1. 90% success Migrate large files to external storage (S3) and store URLs instead 
    Store large assets in S3 with presigned URLs

    Sources: https://docs.github.com/en/repositories/working-with-files/managing-large-files/about-git-large-file-storage

  2. 82% success Use git lfs prune and audit .gitattributes 
    git lfs prune --verify-remote

    Sources: https://github.com/git-lfs/git-lfs/blob/main/docs/man/git-lfs-prune.adoc

Dead Ends

Common approaches that don't work:

  1. Buy more bandwidth packs repeatedly 60% fail

    Bandwidth packs are one-time; recurring large files get expensive fast

  2. Remove LFS tracking to avoid bandwidth limits 80% fail

    Removing tracking does not remove existing LFS objects