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

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.

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 status

How to read the output

  1. find . -type f -size +50M -print — Runs a focused check for Large File Push; compare its output with the symptom before changing anything else.
  2. du -sh * .[^.]* 2>/dev/null — Measures storage usage so you delete the right cache or export folder.
  3. 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.
  4. git status — Shows what Git thinks changed before you pull, commit, or push for Large File Push.

Fix it in this order

  1. Copy the exact Large File Push message before changing anything. Keep the command, folder, and first useful error line together.
  2. Run only the diagnostic part of the command block. If it fails early, do not continue to the later lines yet.
  3. Fix the layer named by the first useful output line: path, permission, package, Python environment, Git state, or browser URL for Large File Push.
  4. Retest with the shortest command that originally failed. Do not restart the whole project until the small test works.
  5. 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

Before you leave the page

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

Related Assistance pages