Push ditolak karena file besar biasanya bukan soal file di folder kerja, tapi file yang sudah masuk commit. Git mengirim seluruh history commit ke GitHub, jadi menghapus file dari Explorer tidak membersihkan commit yang menahannya. Keluarkan file itu dari history atau pindahkan ke Git LFS, lalu push ulang.
Kenapa Push Ditolak karena Large File
Git adalah version control lokal, GitHub adalah hosting repository. GitHub menolak push kalau ada objek file melebihi batasnya. Pesan umum yang muncul adalah remote: error: File … is … larger than the allowed maximum.
Masalahnya, file itu tetap ada di history walau sudah kamu hapus secara manual. Selama commit lama masih menyimpan blob besar tersebut, perintah push tetap mengirimkannya.
- Cek commit terakhir yang membawa file besar.
- Cek seluruh history kalau file pernah di-commit lalu dihapus.
- Pastikan branch lokal dan remote yang kamu push memang sama.
Gunakan perintah ini untuk menemukan pelakunya:
git log --oneline --name-status -10
git rev-list --objects --all | grep -i namafile
git ls-files -s | sort -k4 -n
Tabel Error dan Penyebab Large File
Pesan error adalah petunjuk awal. Cocokkan gejalanya sebelum menjalankan perintah perbaikan.
| Masalah | Penyebab | Solusi |
|---|---|---|
| remote: File too large | Video, ZIP, ISO, dataset masuk commit biasa | Keluarkan dari history atau pindah ke LFS |
| File sudah dihapus tapi push tetap gagal | Blob besar masih ada di commit lama | Tulis ulang history dengan filter-repo atau BFG |
| LFS error saat push | File dilacak LFS setelah terlanjur di-commit biasa | Migrasi history ke LFS lalu push ulang |
Periksa juga remote tujuan. origin adalah remote utama hasil clone atau fork kamu. Jangan memperbaiki branch main padahal push mengarah ke branch lain.
Cara Memperbaiki Push Large File Tanpa Merusak History
Pilih jalur sesuai kondisi. Kalau file besar baru masuk staging, perbaikannya ringan. Kalau sudah masuk beberapa commit, kamu harus menulis ulang history.
- Identifikasi file besar dan statusnya dengan git status dan git log.
- Kalau file masih di staging, keluarkan tanpa menghapus file kerja:
git rm --cached path/nama-file-besar.zip - Tambahkan pola file ke .gitignore bila file itu memang tidak perlu masuk repository.
- Kalau file harus disimpan di GitHub, pindahkan ke Git LFS:
git lfs install git lfs track "*.psd" git add .gitattributes git add path/nama-file-besar.psd - Kalau file besar sudah masuk commit lama, bersihkan history dengan git filter-repo atau BFG dari commit yang mengandung file tersebut.
- Commit ulang perbaikannya, lalu push kembali ke branch yang benar.
Peringatan: git reset –hard, rebase history, dan force push dapat menghilangkan pekerjaan milikmu atau rekan satu tim. Jangan pakai force push kalau branch dipakai bersama sebelum semua orang sinkron. Reset dan revert berbeda. Reset membuang commit, revert membuat commit baru untuk membatalkan perubahan.
FAQ
Apakah cukup hapus file di folder agar push berhasil?
Tidak. Git tetap mendorong blob dari commit lama, jadi file harus dibersihkan dari staging dan history.
Kapan memakai Git LFS untuk file besar?
Pakai LFS untuk aset biner besar yang perlu diversi seperti video, audio, PSD, dataset, atau model.
Push tetap gagal setelah file dihapus, apa berikutnya?
Periksa history dengan rev-list, bersihkan commit penyebabnya, pastikan LFS terinstal, lalu push ke remote dan branch yang tepat.