wils@web ~ $ cat ~/ajuda/como-utilizar-git-lfs-para-gerenciar-arquivos-grandes-em-repositorios-git.md

Desenvolvimento

Como utilizar Git LFS para gerenciar arquivos grandes em repositórios Git

atualizado em 11/08/2026

O Git LFS (Large File Storage) é uma extensão do Git que permite gerenciar arquivos grandes de forma eficiente, evitando que repositórios fiquem pesados.

Introdução

Quando trabalhamos com arquivos grandes, como vídeos, imagens ou modelos de dados, o Git pode se tornar lento e ineficiente. O Git LFS resolve esse problema, armazenando esses arquivos em servidores externos e mantendo apenas referências no repositório Git.

Passo a Passo para Utilizar o Git LFS

1. Instalar o Git LFS

Primeiro, você precisa instalar o Git LFS. Execute o comando apropriado para seu sistema operacional:

  • Ubuntu:
    sudo apt-get install git-lfs
  • Mac:
    brew install git-lfs
  • Windows: Baixe o instalador do site oficial.

2. Inicializar o Git LFS no seu repositório

Após a instalação, você deve inicializar o Git LFS no repositório desejado:

git lfs install

3. Configurar arquivos grandes

Agora, você pode especificar quais tipos de arquivos devem ser gerenciados pelo Git LFS. Por exemplo, para gerenciar arquivos .mp4:

git lfs track "*.mp4"

Isso criará ou atualizará um arquivo chamado .gitattributes no seu repositório.

4. Adicionar e fazer commit dos arquivos

Adicione os arquivos grandes ao seu repositório como faria normalmente:

git add .gitattributes
 git add caminho/para/seu_arquivo.mp4
 git commit -m "Adicionando arquivo grande com Git LFS"

5. Fazer push para o repositório remoto

Por fim, faça o push das suas alterações para o repositório remoto:

git push origin main

Conclusão

O Git LFS é uma ferramenta poderosa para gerenciar arquivos grandes, mantendo seu repositório leve e rápido. Lembre-se de sempre rastrear os tipos de arquivos que você deseja gerenciar com o LFS para garantir um bom desempenho do seu repositório.

Dica: Sempre verifique o tamanho dos arquivos que você está adicionando ao seu repositório e considere usar o Git LFS para qualquer arquivo que ultrapasse 100 MB.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.