GitHub Push Rejected: File Exceeds 100 MB Limit

How to fix it

Try these in order — the most common fix is first.

1. 1. Remove it if it is the most recent unpushed commit

   Copy steps
   1. git rm --cached path/to/file
   2. git commit --amend -C HEAD
   3. git push
   Did this fix it? Yes No

2. 2. Remove it from earlier commits

   Copy steps
   1. Back up the file first
   2. Use git filter-repo (recommended by GitHub) to strip the path from history
   3. Then push; an interactive rebase works only if the commit is on one branch with no merges since
   Did this fix it? Yes No

3. 3. Track large files with Git LFS

   Copy steps
   1. Install Git LFS and run git lfs track "*.psd" (your pattern)
   2. Commit .gitattributes and re-add the file
   3. Each file must fit the max LFS file size of your plan
   Did this fix it? Yes No

4. 4. Distribute binaries as release assets

   Copy steps
   1. Attach large files to a GitHub release instead of committing them
   2. Keep the repository under 1 GB, and under 5 GB at most, as GitHub recommends
   Did this fix it? Yes No

Symptoms

git push fails with 'this exceeds GitHub's file size limit of 100.00 MB' and 'pre-receive hook declined'.

Why it happens

• A single file larger than 100 MiB is in a commit being pushed
• The big file was committed earlier and only deleted in a later commit, so it remains in history
• Files uploaded through the browser are limited to 25 MiB

This guide also covers

• github file exceeds 100 mb
• pre-receive hook declined github large file
• remote file exceeds github's file size limit
• github git lfs setup

Other GitHub errors

• GitHub Permission Denied (publickey) Error
• GitHub 'Password Authentication Was Removed' Error
• GitHub Push Rejected: Updates Were Rejected (Non-Fast-Forward)
• GitHub Push Blocked: Repository Rule Violations (GH013 / Secret Detected)
• GitHub 'Permission Denied' or 403 When Pushing Over HTTPS
• GitHub Locked Out: Lost 2FA Device or Recovery Codes
• GitHub Actions Workflow Stuck in Queued / Waiting for a Runner
• GitHub Actions: 'Recent Account Payments Have Failed or Spending Limit Needs to Be Increased'