# Sobre armazenamento de arquivo grande do Git

O GitHub limita o tamanho dos arquivos permitidos nos repositórios. Para rastrear arquivos além desse limite, você pode usar Armazenamento de Arquivos Grandes do Git.

## Sobre o Armazenamento de Arquivos Grandes do Git

O Git LFS manipula arquivos grandes armazenando referências ao arquivo no repositório, mas não no próprio arquivo. Para explorar a arquitetura do Git, o Git LFS cria um arquivo de ponteiro que funciona como uma referência ao arquivo real (que é armazenado em outro lugar). O GitHub gerencia esse arquivo de ponteiro no seu repositório. Quando você clona o repositório, o GitHub usa o arquivo de ponteiro como um mapa para encontrar o arquivo grande para você.

Diferentes limites de tamanho máximo para o Git LFS se aplicam conforme o seu plano do GitHub.

| Produto                 | Tamanho máximo do arquivo |
| ----------------------- | ------------------------- |
| GitHub Free             | 2 GB                      |
| GitHub Pro              | 2 GB                      |
| GitHub Team             | 4 GB                      |
| GitHub Enterprise Cloud | 5 GB                      |

Quando você excede o limite por arquivo de 5 GB, o arquivo é rejeitado pelo Git LFS com uma mensagem de erro.

Também é possível usar o Git LFS com o GitHub Desktop. Para obter mais informações de como clonar repositórios LFS do Git no GitHub Desktop, confira [Clonar um repositório do GitHub para o GitHub Desktop](/pt/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop).

Você pode escolher se os objetos do Git LFS são incluídos nos [arquivos de código-fonte](/pt/repositories/working-with-files/using-files/downloading-source-code-archives), como arquivos ZIP e tarballs, que o GitHub cria para o repositório. Para saber mais, confira [Gerenciando objetos LFS do Git em arquivos do seu repositório](/pt/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository).

## Formato do arquivo de ponteiro

O arquivo de ponteiro do Git LFS tem esta aparência:

```text
version https://git-lfs.github.com/spec/v1
oid sha256:4cac19622fc3ada9c0fdeadb33f88f367b541f38b89102a3f1261ac81fd5bcb5
size 84977953
```

Ele rastreia a `version` do Git LFS que está sendo usada, seguido de um identificador exclusivo para o arquivo (`oid`). Além disso, armazena o `size` do arquivo final.

> \[!NOTE]
>
> * Git LFS não pode ser usado com sites de GitHub Pages.
> * Git LFS não pode ser usado com repositórios de template.

## Leitura adicional

* ```
            [AUTOTITLE](/repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage) 
  ```
* [Cobrança do Git Large File Storage](/pt/billing/managing-billing-for-your-products/managing-billing-for-git-large-file-storage/about-billing-for-git-large-file-storage)