---
title: "Git LFS"
description: "Store large files in a repository with the stock git lfs client."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git LFS

Repositories take [Git LFS](https://git-lfs.com) files with the standard `git lfs` client: track the
files, commit and push as usual. LFS uses the same credential as Git (the
[credential helper](/git/quickstart) or your API key), and the same clone URL.

```sh
git lfs install
git lfs track "*.mp4"
git add .gitattributes public/hero.mp4
git commit -m "Add the hero video"
git push origin main
```

- One LFS file is at most 5 GiB. A project holds up to 50 GiB of LFS files (adjustable).
- Uploading needs `git.repositories.push` on the repository, and downloading
  `git.repositories.pull`.
- The repository's `lfsBytes` is what its LFS files take.

In the console, an LFS file's page shows its size, with **Download**. Through the API,
[GetContents](/git-api/GetContents/) returns the pointer and its `lfs` (`oid`, `size`), and
[GetBlob](/git-api/GetBlob/) with `lfs=resolve` returns the file itself:

```sh
curl -H "Authorization: Bearer $EZGH_API_KEY" -o hero.mp4 \
  "https://git-api.ezghcloud.com/v1/organizations/$ORG_ID/projects/$PROJECT_ID/repositories/$REPO/blobs/$SHA?lfs=resolve"
```

Source: https://docs.ezghcloud.com/git/lfs/index.mdx
