Configuring Git Large File Storage

Platform navigation

If there are existing files in your repository that you’d like to use with GitHub, you need to first remove them from the repository and then add them to Git LFS locally. For more information, see Moving a file in your repository to Git Large File Storage.

If there are referenced Git LFS files that did not upload successfully, you will receive an error message. For more information, see Resolving Git Large File Storage upload failures.

1. Open Terminal.
2. Change your current working directory to an existing repository you’d like to use with Git LFS.
3. To associate a file type in your repository with Git LFS, enter git lfs track followed by the name of the file extension you want to automatically upload to Git LFS. For example, to associate a .psd file, enter the following command:

   $ git lfs track "*.psd"
   > Tracking "*.psd"

   Every file type you want to associate with Git LFS will need to be added with git lfs track. This command amends your repository’s .gitattributes file and associates large files with Git LFS.
4. Add a file to the repository matching the extension you’ve associated:

   git add path/to/file.psd

5. Commit the file and push it to GitHub:

   git commit -m "add file.psd"
   git push

   You should see some diagnostic information about your file upload:

   > Sending file.psd
   > 44.74 MB / 81.04 MB  55.21 % 14s
   > 64.74 MB / 81.04 MB  79.21 % 3s

• Collaboration with Git Large File Storage
• Managing Git LFS objects in archives of your repository