Como Auto-Hospedar Forgejo no Linode (Guia 2026)

Aplicações de auto-hospedagem como Forgejo podem capacitar desenvolvedores e homelabbers ao fornecer controle sobre seus dados e ferramentas. Neste guia, vamos orientá-lo pelo processo de instalação do Forgejo em uma VPS Linode. Forgejo é um software de código aberto que facilita o gerenciamento de código-fonte usando Git, semelhante a plataformas como GitHub, mas com maior flexibilidade para ambientes auto-hospedados.

Por Que Escolher Linode para Forgejo?

Antes de mergulhar no processo de instalação, vamos discutir brevemente por que o Linode é uma ótima escolha para hospedar o Forgejo. Linode oferece máquinas virtuais de alto desempenho a partir de apenas 5 USD por mês, tornando-se uma opção acessível para desenvolvedores. Sua infraestrutura é otimizada para velocidade e confiabilidade, essenciais para um hospedagem de Git eficiente.

Visão Geral de Preços do VPS Linode

Aqui está uma comparação rápida de provedores de VPS com base em seus preços iniciais:

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

Pré-Requisitos para Auto-Hospedar Forgejo no Linode

Antes de começarmos com a instalação, assegure-se de ter o seguinte:

1. Conta na Linode: Crie uma conta na Linode, se ainda não tiver.
2. Instância de VPS: Crie uma nova instância Linode com pelo menos 2 GB de RAM.
3. Nome de Domínio: É uma boa prática ter um nome de domínio apontado para o IP do seu Linode.
4. Conhecimento Básico de Linha de Comando Linux: Familiaridade com SSH e operações no terminal será útil.

Guia Passo a Passo de Instalação

Passo 1: Acesse Sua Instância Linode

Assim que sua instância Linode estiver ativa, conecte-se via SSH:

ssh root@SEU_IP_DO_LINODE

Substitua SEU_IP_DO_LINODE pelo IP público do seu Linode.

Passo 2: Atualize o Sistema

Garanta que seu sistema está atualizado com os últimos patches de segurança:

sudo apt update && sudo apt upgrade -y

Passo 3: Instale Dependências

Forgejo necessita de várias dependências. Instale-as com:

sudo apt install -y git redis-server nginx postgresql

Certifique-se de que esses serviços estejam habilitados para iniciar automaticamente no boot:

sudo systemctl enable redis-server
sudo systemctl enable postgresql
sudo systemctl start redis-server
sudo systemctl start postgresql

Passo 4: Configure o PostgreSQL

Faça login no PostgreSQL para criar um banco de dados e usuário para o Forgejo. Use os comandos:

sudo -u postgres psql

Depois execute:

CREATE DATABASE forgejo;
CREATE USER forgejo_user WITH PASSWORD 'sua_senha_segura';
GRANT ALL PRIVILEGES ON DATABASE forgejo TO forgejo_user;

Substitua 'sua_senha_segura' por uma senha forte.

Passo 5: Baixe e Instale o Forgejo

Agora, baixe a versão mais recente do Forgejo na página oficial de lançamentos:

wget https://forgejo.org/release/forgejo_latest_linux_amd64.tar.gz
tar -xvzf forgejo_latest_linux_amd64.tar.gz
cd forgejo-*

Passo 6: Configure o Forgejo

Crie um arquivo de configuração baseado no exemplo fornecido:

cp forgejo.sample.toml forgejo.toml

Edite o arquivo forgejo.toml:

nano forgejo.toml

Ajuste as seguintes configurações:

• Conexão com o banco de dados
• Domínio do servidor
• Suas configurações SMTP para notificações de email, se necessário.

Passo 7: Configure o Nginx

Crie um novo arquivo de configuração do Nginx para o Forgejo:

sudo nano /etc/nginx/sites-available/forgejo

Adicione a seguinte configuração:

server {
    listen 80;
    server_name SEU_DOMINIO;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Habilite o site e reinicie o Nginx:

sudo ln -s /etc/nginx/sites-available/forgejo /etc/nginx/sites-enabled/
sudo systemctl restart nginx

Passo 8: Inicie o Forgejo

Por fim, inicie o Forgejo com o comando:

./forgejo server

Sua instância do Forgejo agora deve estar acessível em http://SEU_DOMINIO.

Perguntas Frequentes

Quais são os benefícios de auto-hospedar o Forgejo?

Auto-hospedar o Forgejo oferece controle total sobre seus projetos e dados. Você pode personalizar o ambiente de acordo com suas necessidades, garantindo privacidade e segurança dos seus repositórios. Além disso, evita o lock-in de fornecedores e permite modificar o software conforme desejar.

É difícil configurar o Forgejo no Linode?

Configurar o Forgejo no Linode é direto se você seguir os passos descritos. Com uma compreensão básica de Linux e gerenciamento de servidores, a maioria dos desenvolvedores achará o processo gerenciável. O Linode também fornece ótima documentação e suporte, que podem ajudar durante a instalação.

Posso hospedar várias instâncias do Forgejo em um único Linode?

Embora seja tecnicamente possível hospedar múltiplas instâncias do Forgejo no mesmo Linode configurando portas e domínios diferentes, não é recomendado. Isso pode levar a competição por recursos e redução de desempenho. Geralmente, é melhor alocar instâncias separadas de Linode para configurações de alta disponibilidade.

Concluindo, seguindo este guia, você configurou com sucesso o Forgejo no Linode. Essa configuração permite um fluxo de trabalho de desenvolvimento otimizado, além dos benefícios de auto-hospedagem. Aproveite a flexibilidade do Forgejo e potencialize sua eficiência de desenvolvimento hoje! --- Fim ---