Git LFS
The LFS tab manages Git Large File Storage, which efficiently handles large binary files by storing them on a separate server. It can appear as a mode within Git Settings or as a standalone content tab.
Status
The status section shows:
- LFS binary installation status
- LFS tracking status
- Tracked patterns count
- Local storage size and object count
- Initialize LFS button (if not yet set up)
Tracking Patterns
When LFS is active, the patterns section displays:
- A list of tracked patterns as chips (e.g.,
*.psd,*.zip) - Quick Add input to add new patterns
- Edit .gitattributes button to open the file in the editor
- Renormalize button to apply filter changes to existing files (appears when
.gitattributeshas been modified)
A warning banner appears if .gitattributes has been modified but not yet committed, with a link to open the Changes tab.
Operations
| Button | Action |
|---|---|
| Pull | Download LFS objects from remote |
| Fetch | Fetch LFS metadata without downloading |
| Prune | Remove unreferenced local LFS objects |
| Auto-sync | Toggle automatic LFS pull/push with git operations |
Operations show a progress bar during execution.
Migration Analysis
The migration section helps you identify files that should be tracked by LFS:
- Click Analyze to scan the repository for files matching common binary patterns
- Review the results table showing per-pattern matches
- Click Migrate on individual patterns to rewrite history and move matching files to LFS