GH001 large files 🌿 Git

remote: error: GH001: Large files detected. File x is 120 MB; this exceeds GitHub's file size limit of 100.00 MB

GitHub rejected the push because a file over 100 MB is in your commits — even if you deleted it later.

Seen on: Git

Meaning

The large file is in history, so deleting it in a new commit isn’t enough. Remove it from the commits (rewrite history) and use Git LFS for large binaries.

Common causes

  • Large binaries, datasets, videos or build artifacts committed
  • node_modules/vendor committed with large binaries

⚡ Quick fix

  1. Remove from history: git filter-repo --path bigfile --invert-paths
  2. If it’s only in the last commit: git rm --cached bigfile && git commit --amend
  3. Track large files with Git LFS

Detailed fix by platform

Git

  1. git lfs install && git lfs track "*.mp4" && git add .gitattributes

How to diagnose

  1. File — Which path and size?
  2. Commits — Which commits contain it?

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.