Git LFS for large files - Step-by-Step Execution

Process Flow - Git LFS for large files

Start: Large file in project

↓

Track file with Git LFS

↓

Add file to Git index

↓

Commit changes

↓

Push to remote repository

↓

Large file stored in LFS server

↓

Pointer file stored in Git repo

This flow shows how Git LFS tracks large files by replacing them with small pointer files in Git, while storing the actual large files on a separate server.

Execution Sample

Git

git lfs track "*.psd"
git add .gitattributes
git add bigfile.psd
git commit -m "Add large PSD file"
git push origin main

This sequence tracks PSD files with Git LFS, adds the tracking config, stages the large file, commits, and pushes to remote.

Process Table

Step	Command	Action	Result
1	git lfs track "*.psd"	Add pattern to .gitattributes	Files matching *.psd tracked by LFS
2	git add .gitattributes	Stage .gitattributes file	.gitattributes ready to commit
3	git add bigfile.psd	Stage large PSD file	Pointer file staged instead of full file
4	git commit -m "Add large PSD file"	Commit changes	Commit includes pointer and .gitattributes
5	git push origin main	Push commit and LFS objects	Pointer pushed to Git repo; large file pushed to LFS server
6			Execution ends: large file stored separately, Git repo has pointer

💡 Push completes with large file stored on LFS server and pointer in Git repository

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5
.gitattributes	empty	contains '*.psd filter=lfs diff=lfs merge=lfs -text'	staged	staged	committed	committed
bigfile.psd	untracked	untracked	untracked	staged as pointer	committed as pointer	pushed to LFS server
Git commit	none	none	none	none	created with pointer	pushed
LFS server	empty	empty	empty	empty	empty	large file stored

Key Moments - 3 Insights

Why does 'git add bigfile.psd' stage a pointer file instead of the full file?

Because Git LFS replaces the large file with a small pointer file during staging, as shown in execution_table step 3.

What happens to the large file when we push to the remote repository?

The large file is uploaded to the LFS server separately, while Git stores only the pointer, as seen in execution_table step 5.

Why do we need to add and commit the .gitattributes file?

Because .gitattributes tells Git which files to track with LFS, so it must be committed before adding large files (execution_table steps 1 and 2).

Visual Quiz - 3 Questions

Look at the execution table, what is staged when running 'git add bigfile.psd'?

A Nothing is staged

B The full large file content

C A pointer file representing the large file

D Only .gitattributes file

💡 Hint

See execution_table step 3 where staging replaces the large file with a pointer

At which step is the large file actually uploaded to the LFS server?

A Step 2

B Step 5

C Step 3

D Step 4

💡 Hint

Check execution_table step 5 where push uploads LFS objects

If we forget to commit .gitattributes before adding large files, what happens?

A Large files are added as normal files to Git

B Large files are tracked by LFS anyway

C Git throws an error

D Pointer files are created but not committed

💡 Hint

Refer to variable_tracker showing .gitattributes must be committed first to enable LFS tracking

Concept Snapshot

Git LFS tracks large files by replacing them with small pointer files in Git.
Use 'git lfs track "pattern"' to specify files.
Add and commit .gitattributes to enable tracking.
Add large files normally; Git stores pointers.
Push uploads pointers to Git and large files to LFS server.
This keeps Git repos fast and small.

Full Transcript

Git LFS helps manage large files by storing them outside the main Git repository. First, you tell Git LFS which files to track using 'git lfs track' which updates the .gitattributes file. Then you add and commit this file so Git knows to use LFS for those files. When you add a large file matching the pattern, Git LFS stages a small pointer file instead of the full file. Committing saves this pointer in Git. When you push, Git sends the pointer to the Git server and uploads the actual large file to the LFS server. This way, your Git repository stays small and fast, while large files are stored efficiently. The execution table shows each step from tracking, adding, committing, to pushing, and the variable tracker shows how files and pointers change state. Key moments clarify why pointers are staged and how the large files are uploaded separately. The quiz tests understanding of these steps.