Large file versioning
Version large files—even those as large as a couple GB in size—with Git.
Git Large File Storage (LFS) replaces large files such as audio samples, videos, datasets, and graphics with text pointers inside Git, while storing the file contents on a remote server like GitHub.com or GitHub Enterprise.
Download v3.5.1 (Mac - Intel Silicon)
Download v3.5.1 (Mac - Apple Silicon)
Homebrew: brew install git-lfs
MacPorts: port install git-lfs
Download and install the Git command line extension. Once downloaded and installed, set up Git LFS for your user account by running:
git lfs install
You only need to run this once per user account.
In each Git repository where you want to use Git LFS, select the file types you'd like Git LFS to manage (or directly edit your .gitattributes). You can configure additional file extensions at anytime.
git lfs track "*.psd"
Now make sure .gitattributes is tracked:
git add .gitattributes
Note that defining the file types Git LFS should track will not, by itself, convert any pre-existing files to Git LFS, such as files on other branches or in your prior commit history. To do that, use the git lfs migrate(1) command, which has a range of options designed to suit various potential use cases.
There is no step three. Just commit and push to GitHub as you normally would; for instance, if your current branch is named main
:
git add file.psd git commit -m "Add design file" git push origin main
Check out our wiki, discussion forum, and documentation for help with any questions you might have!
To start a discussion, file an issue, or contribute to the project, head over to the repository or read our guide to contributing.
If you're interested in integrating Git LFS into another tool or product, you might want to read the API specification or check out our reference server implementation.
Version large files—even those as large as a couple GB in size—with Git.
Host more in your Git repositories. External file storage makes it easy to keep your repository at a manageable size.
Download less data. This means faster cloning and fetching from repositories that deal with large files.
Work like you always do on Git—no need for additional commands, secondary storage systems, or toolsets.
Keep the same access controls and permissions for large files as the rest of your Git repository when working with a remote host like GitHub.