Large File Push
Fix GitHub push failures caused by huge ZIPs, PDFs, videos, build folders, cache files, and accidental large commits from Termux.
What this page is for
Large File Push is for git push is rejected because files are too large for GitHub. This is a practical phone-first repair path, so every step should be testable inside Termux before you move on for Large File Push.
Work on Large File Push only after you can point to the exact clue in the terminal or browser output. For this guide, the main clues are large, file, push, git, and the page description is: Fix GitHub push failures caused by huge ZIPs, PDFs, videos, build folders, cache files, and accidental large commits from Termux.
Signs you are on the right page
- The same problem returns after a normal retry and it matches this topic: git push is rejected because files are too large for GitHub.
- The output mentions large, file, push, git, or the failure happens immediately after a command connected to Large File Push.
- You can reproduce the Large File Push problem with one short test command instead of launching the whole project again.
- Find large files and remove them from history or release them another way.
Why it happens in Termux
Large File Push belongs to the Git and repository state layer. In Termux, that layer can change because Android paths, package state, working folders, cached browser files, or Git settings are not shared the way they are on a desktop Linux system for Large File Push.
- For Large File Push, look for large, file, push, git in the first useful output line. That line decides whether you should fix a path, dependency, permission, port, or repository setting for Large File Push.
- Git has not been told which user.name and user.email to use for commits for Large File Push.
- GitHub requires a token or SSH key; the normal account password is not accepted for command-line pushes for Large File Push.
- Local edits and remote edits touched the same files, so pull or push needs a careful merge path for Large File Push.
Copyable command
Run this from the folder that belongs to Large File Push. Replace placeholder names before pressing Enter.
find . -type f -size +50M -print
du -sh * .[^.]* 2>/dev/null
printf "\n*.zip\nnode_modules/\n__pycache__/\n" >> .gitignore
git statusHow to read the output
- find . -type f -size +50M -print — Runs a focused check for Large File Push; compare its output with the symptom before changing anything else.
- du -sh * .[^.]* 2>/dev/null — Measures storage usage so you delete the right cache or export folder.
- printf "\n*.zip\nnode_modules/\n__pycache__/\n" >> .gitignore — Runs a focused check for Large File Push; compare its output with the symptom before changing anything else.
- git status — Shows what Git thinks changed before you pull, commit, or push for Large File Push.
Fix it in this order
- Copy the exact Large File Push message before changing anything. Keep the command, folder, and first useful error line together.
- Run only the diagnostic part of the command block. If it fails early, do not continue to the later lines yet.
- Fix the layer named by the first useful output line: path, permission, package, Python environment, Git state, or browser URL for Large File Push.
- Retest with the shortest command that originally failed. Do not restart the whole project until the small test works.
- When it works, write down the final command in your notes or README so the same Large File Push problem is easier next time.
Common mistakes
- Jumping from Large File Push to a full reinstall even though one smaller check can identify the failing layer.
- Trying to push before checking git status.
- Using a GitHub password where a token or SSH key is required.
- Deleting the repository to escape a conflict before making a backup zip for Large File Push.
Before you leave the page
- The original Large File Push output should be gone, shorter, or replaced by a different and more specific error.
- You should know which folder you were in and which command changed the result for Large File Push.
- You should have a backup before deleting files, overwriting repositories, or changing working scripts for Large File Push.
Guide did not solve it?
If Git still blocks you, use the Store and send git status, the exact push/pull/clone command, and the first authentication or merge error shown for Large File Push. Mention that the page you tried was: Large File Push.
Open Store / Get Help