GitHub rejects a file over 100 MB

Severity Annoying

What just happened

A big file (video, dataset, build, node_modules…) is in one of your unpushed commits. Deleting it in a new commit is not enough: it is still in the history Git tries to send.

Potential risks

Rewriting already-pushed commits affects your teammates.

Before you run anything

Need to version big files? Use Git LFS instead.
Golden rule: before any destructive command, create a safety branch with git branch backup/before-fix — it costs nothing.

Recovery steps

1
Find the commit that added it
Lists the local commits not yet on the remote, with their files.
Safe
```
$ git log --stat origin/main..HEAD
```

It's in the last commit

Remove it from the commit but keep it on disk, then ignore it.

Caution

$ git rm --cached path/to/big-file
$ echo "path/to/big-file" >> .gitignore
$ git commit --amend --no-edit

3
It's in an older unpushed commit
Rewrites every unpushed commit to drop the file. Needs git filter-repo (installed separately); --force because this is not a fresh clone. Make a backup branch first.
Destructive
```
$ git branch backup/before-fix
$ git filter-repo --force --invert-paths --path path/to/big-file --refs origin/main..HEAD
```

These procedures are provided for information only. Read each command and adapt it to your situation before running it. Disclaimer

Other disasters

🪓 I deleted my branch 🚨 I pushed directly to main 💥 I ran git reset --hard 🧨 I overwrote a colleague's commits 🔑 I pushed my .env file to GitHub 🔀 I made a bad merge 👻 I lost uncommitted changes 🎯 I committed on the wrong branch 🎈 I'm in “detached HEAD” state ⚔️ I'm stuck in a merge conflict 🚫 My push is rejected (non-fast-forward)🌀 My rebase went wrong 🥸 I committed with the wrong name or email 🗑️ I deleted a file and committed it ⏪ I want to undo my last commit ✏️ I amended a commit that was already pushed 🧹 Too many messy commits to clean up 📮 I pushed to the wrong branch 🧭 I rebased onto the wrong branch 🔁 I need back the changes I reverted 📦 git stash pop gave me a conflict 🙈 I committed a file that should be ignored 🔠 Git doesn't see my file rename (upper/lower case)🧨 I ran git clean -fd by mistake 🩻 My repository is corrupted 🙃 I forgot to pull before pushing 👯 Duplicated lines of code after a merge ➖ I added a file I didn't want to (git add)✏️ I made a typo in a commit message ✂️ My commit does too many things 🧺 I lost a stash (drop, clear or pop gone wrong)🫥 I pulled and my code disappeared 🍒 I cherry-picked the wrong commit ☁️ I deleted a branch on GitHub / GitLab 👥 I pushed with the wrong GitHub account 🚚 The repository was renamed or moved 🏷️ I tagged the wrong commit 🌊 Git says every file is modified, but I changed nothing 📦 I committed node_modules (or a build folder)📂 I ran git init in the wrong folder 🧨 My pull request has conflicts ⏳ My pull request is behind main 📝 I have to apply review changes to my PR 🧳 My PR shows commits that aren't mine 🎯 I opened my PR against the wrong branch 🚨 A merged PR broke main 🚪 I closed my PR (or deleted its branch) by mistake 🔴 The checks of my PR are failing 🐘 My PR is too big to review 🍴 My fork is behind the original repository