Como Auto-Hospedar Forgejo na Contabo (Guia 2026)

Forgejo é um serviço de Git de código aberto, auto-hospedado e popular, que permite aos desenvolvedores gerenciar seus repositórios de código de forma eficiente. Este guia mostrará como instalar e configurar o Forgejo em uma VPS da Contabo, garantindo que você maximize o desempenho do seu servidor enquanto mantém tudo seguro.

Por que escolher Contabo para auto-hospedagem?

A Contabo oferece preços competitivos e uma infraestrutura robusta, tornando-se uma opção atraente para aplicações de auto-hospedagem como o Forgejo. Veja uma rápida comparação de alguns provedores populares de VPS:

Para comparações detalhadas, confira nossa comparação completa de VPS.

Pré-requisitos

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

1. Uma VPS da Contabo com pelo menos 2 GB de RAM (recomendado).
2. Conhecimento básico de SSH e interface de linha de comando.
3. Um nome de domínio para vincular à sua instância do Forgejo (opcional).

Passo 1: Configurando sua VPS na Contabo

1. Faça login na sua VPS da Contabo:

   • Use SSH para se conectar:

     ssh root@seu_ip_vps

2. Atualize seu sistema:

   apt update && apt upgrade -y

3. Instale pacotes essenciais:

   apt install curl git -y

Passo 2: Instalar Docker

O Forgejo funciona de forma eficiente usando Docker. Para instalá-lo, siga estes passos:

1. Instale o Docker:

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

2. Adicione seu usuário ao grupo do Docker (opcional para uso sem root):

   usermod -aG docker $USER

3. Verifique a instalação do Docker:

   docker --version

Passo 3: Implantar o Forgejo usando Docker

1. Crie uma rede Docker:

   docker network create forgejo

2. Crie um diretório para os dados do Forgejo:

   mkdir -p /opt/forgejo/{data,logs}

3. Crie um arquivo docker-compose.yml:

   nano /opt/forgejo/docker-compose.yml

   Adicione o seguinte conteúdo ao seu docker-compose.yml:

   version: '3'
   
   services:
     forgejo:
       image: forgejo/forgejo:latest
       restart: always
       networks:
         - forgejo
       ports:
         - "3000:3000" # Interface web do Forgejo
       volumes:
         - ./data:/data
         - ./logs:/logs
       environment:
         - SECRET_KEY_BASE=sua_chave_secreta
         - APP_URL=http://seu_dominio_ou_ip:3000

   Substitua sua_chave_secreta por uma chave segura gerada com:

   openssl rand -hex 32

   E substitua seu_dominio_ou_ip pelo seu domínio ou endereço IP.

Passo 4: Iniciar o Forgejo

1. Navegue até o diretório do Forgejo:

   cd /opt/forgejo

2. Execute o container do Forgejo:

   docker-compose up -d

3. Verifique os logs para garantir que iniciou com sucesso:

   docker-compose logs -f

Passo 5: Acessando o Forgejo

1. Abra seu navegador e acesse:

   http://seu_dominio_ou_ip:3000

2. Você será recebido pela página de configuração do Forgejo. Siga os passos para criar sua conta de administrador.

Perguntas Frequentes

Quão seguro é o Forgejo ao auto-hospedá-lo na Contabo?

Auto-hospedar o Forgejo na Contabo é relativamente seguro se as melhores práticas forem seguidas. Sempre use uma chave secreta forte e ative HTTPS para sua instância do Forgejo. Você pode usar um proxy reverso como Nginx para gerenciar o SSL. Atualize regularmente suas imagens Docker e a própria aplicação do Forgejo para corrigir vulnerabilidades.

Quais as principais vantagens de usar o Forgejo?

O Forgejo oferece várias vantagens, incluindo uma interface amigável para gerenciar repositórios, acompanhamento de issues e integração CI/CD. Além disso, ser auto-hospedado significa que você tem controle total sobre seus dados e repositórios, o que é fundamental para desenvolvedores preocupados com privacidade e segurança de dados.

Como faço para fazer backup dos meus dados do Forgejo?

Fazer backup dos seus dados do Forgejo é fundamental para evitar perda de informações. Como o Forgejo usa Docker, você pode fazer backup criando um arquivo tar do diretório de dados. Execute o comando abaixo:

tar -czvf forgejo_backup.tar.gz /opt/forgejo/data

Considere automatizar esse processo de backup usando tarefas cron para garantir backups regulares sem intervenção manual.

Seguindo este guia, você deverá conseguir configurar com sucesso o Forgejo na sua VPS da Contabo. Se desejar explorar mais soluções auto-hospedadas, visite o subreddit r/selfhosted ou o repositório awesome-selfhosted no GitHub para recursos adicionais. Boa hospedagem!