Como Auto-Hospedar Forgejo na Vultr (Guia 2026)

Forgejo é uma plataforma de desenvolvimento de software open-source, um fork do Gitea que permite hospedar um ambiente colaborativo de codificação. Neste guia detalhado, cobriremos como instalar e configurar o Forgejo na Vultr, um dos melhores provedores de VPS para desenvolvedores. Com planos a partir de apenas 6 USD por mês, a Vultr oferece infraestrutura robusta para suas necessidades de auto-hospedagem.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Uma conta na Vultr. Se precisar, inscreva-se aqui.
• Compreensão básica de linha de comando do Linux.
• Acesso SSH à sua instância de servidor.

Passo 1: Criar uma Instância na Vultr

1. Faça login na sua conta Vultr.
2. Clique em Deploy Now.
3. Escolha um sistema operacional. Para Forgejo, recomendamos usar o Ubuntu 22.04.
4. Selecione o tamanho do servidor. O plano de US$6/mês é adequado para projetos pequenos.
5. Escolha uma localização do servidor próxima à sua audiência.
6. Clique em Deploy Now e aguarde até a instância estar pronta.

Passo 2: Conectar-se ao Seu Servidor

Depois que seu servidor estiver ativo e em funcionamento, conecte-se via SSH. Abra seu terminal e use o seguinte comando:

ssh root@seu_ip_do_servidor

Substitua seu_ip_do_servidor pelo endereço IP real da sua instância Vultr.

Passo 3: Preparação do Sistema

Atualize e melhore a lista de pacotes com os seguintes comandos:

sudo apt update
sudo apt upgrade -y

Instale as dependências necessárias:

sudo apt install -y git curl build-essential

Passo 4: Instalar Docker

Docker é a forma mais fácil de colocar o Forgejo em funcionamento. Instale o Docker executando:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Adicione seu usuário ao grupo Docker:

sudo usermod -aG docker $USER

Faça logout e login novamente no seu servidor para aplicar as mudanças no grupo.

Verifique a instalação do Docker:

docker --version

Passo 5: Configurar o Forgejo

Agora, vamos puxar a imagem Docker do Forgejo e criar um container:

docker run -d --name forgejo \
  -p 3000:3000 \
  -p 222:22 \
  -v /srv/forgejo:/data \
  forgejo/forgejo:latest

Você pode modificar as portas conforme sua configuração existente. A porta padrão para acesso web será 3000, enquanto o SSH funcionará na porta 222.

Agora, você pode acessar o Forgejo visitando http://seu_ip_do_servidor:3000 no seu navegador.

Passo 6: Configurar o Forgejo

Ao acessar o Forgejo, você será guiado pelo setup inicial:

1. Configuração do Banco de Dados: se precisar de um banco de dados, pode usar PostgreSQL ou MySQL.
2. Configuração do Usuário Administrador: crie uma conta de usuário administrador para gerenciar sua instância.
3. Webhooks e Integrações: configure webhooks necessários para integração com ferramentas de CI/CD ou outros serviços.

Passo 7: Protegendo Sua Instalação

Após configurar o Forgejo, é recomendável proteger sua instância. Aqui estão algumas boas práticas:

• Ativar SSL: considere usar Let’s Encrypt para certificados SSL gratuitos.
• Configuração do Firewall: use UFW para limitar o acesso às portas necessárias (HTTP, HTTPS, SSH).
• Backups Regulares: assegure-se de fazer e armazenar backups periodicamente.

Tabela de Comparação de Provedores de VPS

Para uma comparação completa de VPS, confira este link.

Perguntas Frequentes (FAQs)

Para que serve o Forgejo?

Forgejo é um serviço de Git auto-hospedado que oferece uma plataforma colaborativa para desenvolvedores gerenciarem seus repositórios de código. Ele fornece ferramentas para controle de versão, gerenciamento de projetos e integrações com pipelines de CI/CD. Isso permite que equipes e indivíduos hospedem seus projetos de forma segura, mantendo controle sobre seu código e fluxos de trabalho. O Forgejo enfatiza desempenho e experiência do usuário, sendo ideal tanto para pequenas quanto grandes equipes de desenvolvimento.

Como o Docker facilita o processo de instalação do Forgejo?

Usar Docker para instalar o Forgejo simplifica muito o processo de deploy. Os containers Docker permitem empacotar a aplicação junto com suas dependências, garantindo consistência entre ambientes diferentes. Você não precisa se preocupar em instalar bibliotecas ou dependências manualmente, pois tudo o que é necessário roda em um ambiente isolado. Isso acelera a instalação e também facilita o gerenciamento de atualizações e rollback.

Posso instalar o Forgejo em outros provedores de VPS além da Vultr?

Sim, definitivamente você pode instalar o Forgejo em outros provedores de VPS. Os passos de configuração permanecem basicamente os mesmos, desde que o servidor rode um sistema operacional compatível, como Ubuntu. Provedores como Contabo, Hetzner, DigitalOcean e Linode oferecem planos acessíveis, ideais para auto-hospedagem de aplicações como Forgejo. Sempre verifique se os requisitos mínimos do sistema estão atendidos e se o Docker está instalado para uma instalação tranquila.

Com este guia, você estará bem encaminhado para auto-hospedar o Forgejo na Vultr e aproveitar os benefícios de uma plataforma de codificação personalizada. Bom coding!