Passo a passo: Como configurar um servidor Git próprio

Configurar um servidor Git próprio permite armazenar repositórios privados, garantir maior controle sobre o código e evitar dependências de plataformas externas.

Como configurar um servidor Git próprio?

Ter um servidor Git próprio permite armazenar repositórios de forma independente, garantindo maior controle sobre o código e a segurança do versionamento. Isso é útil para empresas que não querem depender de serviços como GitHub, GitLab ou Bitbucket.

1. Instalando o Git no servidor

Para começar, instale o Git no servidor (Linux):

sudo apt update && sudo apt install git

Crie um usuário dedicado ao Git:

sudo adduser git

2. Criando um repositório bare

O repositório bare (--bare) é um tipo especial de repositório usado para armazenamento remoto. Para criar um:

mkdir -p /home/git/repositorio.git
cd /home/git/repositorio.git
git init --bare

Agora, defina as permissões adequadas:

chown -R git:git /home/git/repositorio.git
chmod -R 770 /home/git/repositorio.git

3. Configurando acesso via SSH

Para permitir que desenvolvedores acessem o repositório, adicione suas chaves SSH ao usuário git:

mkdir /home/git/.ssh
nano /home/git/.ssh/authorized_keys

Cole as chaves públicas dos usuários autorizados.

4. Clonando o repositório no cliente

Agora, qualquer desenvolvedor pode clonar o repositório do servidor:

git clone git@seu-servidor:/home/git/repositorio.git

5. Configurando permissões de push

Caso precise restringir quem pode fazer push para o repositório, utilize hooks no Git (post-receive ou pre-receive) para validar os commits antes de serem aceitos.

Configurar um servidor Git próprio é uma excelente opção para equipes que querem controle total sobre seus repositórios. Diferente de serviços como GitHub e GitLab, um servidor próprio permite configurar permissões, armazenar repositórios internos e até mesmo criar processos de integração contínua personalizados.

Além da segurança, empresas que precisam manter código-fonte privado ou trabalhar em redes internas podem se beneficiar dessa abordagem. Ferramentas como Gitolite e Gitea facilitam a administração de servidores Git, adicionando recursos de gerenciamento de usuários e permissões avançadas.

Algumas aplicações:

  • Gerenciar repositórios privados sem depender de serviços externos
  • Garantir maior segurança e controle sobre o código
  • Implementar fluxos de CI/CD personalizados
  • Permitir que times internos colaborem sem expor código a terceiros
  • Configurar regras de acesso e permissões específicas para cada repositório

Dicas para quem está começando

  • Use um usuário dedicado ao Git para evitar problemas de permissão no servidor.
  • Habilite autenticação SSH para maior segurança no acesso ao repositório.
  • Considere ferramentas como Gitolite ou Gitea para facilitar a administração.
  • Faça backups regulares dos repositórios para evitar perda de código.
  • Se quiser uma interface web, experimente instalar o GitLab em seu servidor.
Foto de Ricardo Moura
Contribuições de
Ricardo Moura

Especialista em Git, fluxos de trabalho colaborativos e integração contínua.

Mais sobre o autor
Compartilhe este tutorial: Como configurar um servidor Git próprio

Compartilhe este tutorial

Continue aprendendo:

Como assinar commits com GPG no Git

A assinatura GPG no Git permite validar a identidade do autor de um commit, garantindo a autenticidade das mudanças no repositório.

Tutorial anterior

Como melhorar a performance de repositórios grandes no Git

A performance de repositórios grandes no Git pode ser melhorada usando ferramentas como Git LFS, shallow clones e pruning de objetos desnecessários.

Próximo tutorial