As GitHub introduced unlimited private repositories, I uploaded gigabytes of data to GitHub repository. Here is some technical notes for uploading many files to GitHub repository.
Storage and bandwidth limit of large files
Git Large File Storage (LFS) is required to push a file larger than 100 MB to GitHub repository. There is a storage and bandwidth limit for LFS, and if you exceed the limit you need to buy extra storage and bandwidth.
You may want to use LFS to handle the large files, or you may just want to ignore the large files. Both methods are written in this article.
Create a repository
Sign in to GitHub and create a repository with
New reposiroty button (Don't check
Initialize this repository with a README). If there is no
REAME.md, create a tentative file with
echo "# test" >> README.md
and run the following commands to initialize the repository and add README.md (
Rewrite USER and REP).
git init git add README.md git commit -m "First commit" git remote add origin email@example.com:USER/REP.git git push -u origin master
Remove spaces from the file names
This command replace spaces " " into underscores "_" in the file names under the current directory.
for A in $(find . | grep " " | sed -e s/" "/x3Exe/g) ; do mv "$(echo $A | sed -e s/x3Exe/' '/g)" "$(echo $A | sed -e s/x3Exe/'_'/g)"; done
If there are spaces in the name of the directory, error may arise. Just repeat this command until no error is shown.
Manage file with LFS
Skip this step when not using LFS. For using LFS, install LFS first. Then setup LFS to Git by
git lfs install
Files larger than 100 MB can be listed with
find . -size +100M | xargs du -sh
Designate the file to manage with LFS from this list. For example, to track files of .psd extention:
git lfs track "*.psd"
Ignore large files
When not using LFS, large files can be ignored with
To add all the files larger than 100 MB to
find . -size +100M | sed -e 's/^\.\///' >> .gitignore
Increase the HTTP post buffer size
When pushing large files, error may arise
packet_write_wait: Connection to 126.96.36.199: Broken pipe
fatal: The remote end hung up unexpectedly
error: failed to push some refs to 'firstname.lastname@example.org:USER/REP.git'
To avoid this, increasing the HTTP post buffer size is recommended. To increase the buffer size to 50 MB,
git config http.postBuffer 52428800
Adding files to repository
Standard way to adding all the files to repository is
git add -A; git commit; git push, but it does not succeed when trying to add gigabytes of files;
fatal: The remote end hung up unexpectedly error arises even when the HTTP buffer size is increased. Therefore I made the following shell script,
gitadd, to add all the files in the current directory step by step.
When you get error by
git add -A; git commit; git push, you can reset the commit and index by
git reset HEAD~ and run
gitadd after that.