Como Auto-Hospedar Gitea no DigitalOcean (Guia 2026)

Introdução

Gitea é um serviço Git leve e auto-hospedado que oferece uma interface web para gerenciar repositórios Git. Configurar o Gitea no DigitalOcean pode ser uma excelente opção para desenvolvedores que desejam controlar seu fluxo de trabalho Git sem depender de serviços externos. Este guia irá orientá-lo por todo o processo, desde a provisão de um VPS até a instalação e configuração do Gitea.

Passo 1: Provisionar um VPS no DigitalOcean

Antes de instalar o Gitea, é necessário provisionar um servidor privado virtual (VPS) no DigitalOcean. Aqui está uma comparação rápida das opções de VPS adequadas para hospedar o Gitea:

Ao escolher um VPS, considere seu uso previsto e selecione um plano que atenda às suas necessidades. Para uma configuração básica do Gitea, a opção do DigitalOcean por $6/mês é uma escolha confiável.

Provisione seu VPS criando uma conta em DigitalOcean. Após o login, crie um droplet usando Ubuntu 20.04 (ou a versão LTS mais recente).

Passo 2: Configurando seu VPS

Assim que seu VPS estiver pronto, conecte-se a ele via SSH:

ssh root@<seu_ip_do_droplet>

Atualize seu sistema

Antes de instalar o Gitea, garanta que seu sistema esteja atualizado:

sudo apt update && sudo apt upgrade -y

Instale as dependências

O Gitea requer Git, um servidor de banco de dados e outras dependências. Instale-os com:

sudo apt install git sqlite3 -y

SQLite é um banco de dados leve excelente para implantações pequenas.

Passo 3: Instalar o Gitea

Baixe o Gitea

Você precisará baixar o binário mais recente do Gitea. Verifique as lançamentos do Gitea no GitHub para a versão mais recente. Use o comando abaixo para fazer o download direto para seu servidor:

wget -O gitea.gz https://dl.gitea.io/gitea/<versao>/gitea-<versao>-linux-amd64

Extraia e mova o binário para /usr/local/bin:

sudo tar - -xzvf gitea.gz
sudo mv gitea /usr/local/bin/
sudo chmod +x /usr/local/bin/gitea

Crie diretórios necessários

Agora crie diretórios para o Gitea armazenar seus arquivos:

sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R root:root /var/lib/gitea/

Crie um usuário para o Gitea

Crie um usuário dedicado para rodar o Gitea:

sudo adduser --disabled-login --gecos 'Gitea' gitea

Configure o Gitea

Crie um arquivo de serviço para gerenciar o Gitea com systemd:

sudo nano /etc/systemd/system/gitea.service

Adicione o seguinte conteúdo:

[Unit]
Description=Gitea
After=network.target

[Service]
User=gitea
Group=gitea
WorkingDirectory=/var/lib/gitea
ExecStart=/usr/local/bin/gitea web
Restart=always
Environment=USER=gitea HOME=/var/lib/gitea GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

Inicie o Gitea

Habilite e inicie o serviço do Gitea:

sudo systemctl enable gitea
sudo systemctl start gitea

Passo 4: Configure o Gitea via Interface Web

Acesse http://<seu_ip_do_droplet>:3000 no navegador. Você deverá ver a página de configuração do Gitea.

1. Configurações do Banco de Dados: Escolha SQLite para uma configuração simples.
2. Conta de Administrador: Crie uma conta para gerenciar o Gitea.
3. URL da Aplicação: Configure a URL da sua aplicação (ex., http://<seu_ip_do_droplet>:3000).

Após preencher todos os campos, clique no botão “Instalar Gitea” para finalizar a configuração.

FAQs

O que é Gitea e por que devo auto-hospedá-lo?

Gitea é um serviço Git leve e auto-hospedado que oferece uma interface simples e personalizável para gerenciar repositórios Git. Ao hospedar o Gitea você tem controle total sobre seus dados, evita dependência de fornecedores externos e pode personalizar sua instalação de acordo com suas necessidades específicas. Isso é especialmente vantajoso para desenvolvedores e equipes que valorizam privacidade e segurança ou que gerenciam seu próprio ciclo de vida de desenvolvimento de software.

Quanto custa hospedar o Gitea no DigitalOcean?

Hospedar o Gitea no DigitalOcean começa a partir de $6 por mês pelo droplet básico, que oferece 1GB de RAM, 25GB de armazenamento SSD e 1 vCPU. Essa configuração é suficiente para equipes pequenas ou projetos individuais. Os custos podem aumentar se você precisar de mais recursos, dependendo das suas demandas. Considere também outros custos possíveis, como registro de domínio e backups.

Posso usar um banco de dados diferente do SQLite para o Gitea?

Sim, o Gitea suporta vários bancos de dados, incluindo MySQL, PostgreSQL e MSSQL, além do SQLite. Embora o SQLite seja adequado para instalações menores, implantações maiores ou ambientes profissionais podem se beneficiar do uso de MySQL ou PostgreSQL devido à sua escalabilidade e desempenho. Consulte a documentação do Gitea para instruções detalhadas de configuração para o banco de dados de sua escolha.

Conclusão

Configurar o Gitea no DigitalOcean é um processo simples que pode melhorar bastante seu fluxo de trabalho de desenvolvimento de software. Com este guia, agora você pode gerenciar seus próprios repositórios Git, mantendo controle completo e personalização sobre seu ambiente. Para uma compreensão mais ampla das opções de VPS, confira a comparação completa de VPS.

Aproveite a comunidade de auto-hospedagem explorando recursos em r/selfhosted ou contribuindo com listas como a awesome-selfhosted. Boas codificações!