O que é o Forgejo?
O Forgejo é uma forge de software leve auto-hospedada. Fácil de instalar e com baixa manutenção, ele simplesmente funciona. O Forgejo é um fork do Gitea impulsionado pela comunidade, focado em segurança, privacidade e governança democrática — oferecendo uma alternativa auto-hospedada ao GitHub ou GitLab que você controla totalmente.
⚡ Principais Recursos do Forgejo
📦 Hospedagem de Repositórios Git
Hospede repositórios git públicos e privados ilimitados. Suporte completo para Git LFS, armazenamento de arquivos grandes e espelhamento de repositórios do GitHub, GitLab e mais.
🔄 Pull Requests & Revisão de Código
Fluxo de trabalho de pull request integrado com revisão de código inline, atribuições de revisão, revisores obrigatórios e estratégias de merge incluindo squash e rebase.
🐛 Rastreamento de Issues
Rastreador de issues completo com etiquetas, marcos, quadro de projetos, campos personalizados e referências entre repositórios.
⚙️ Forgejo Actions
Motor CI/CD integrado compatível com workflows do GitHub Actions. Use as actions existentes do marketplace do GitHub Actions em seu runner auto-hospedado.
📚 Registro de Pacotes
Hospede seus próprios pacotes: npm, PyPI, Maven, imagens Docker/OCI, pacotes Debian/RPM, charts Helm e mais — tudo em um só lugar.
🔐 Segurança & Controle de Acesso
Permissões refinadas, autenticação de dois fatores, provedor OAuth2, integração LDAP/SAML, acesso SSH e HTTPS, regras de proteção de branch.
🏆 Por que o Forgejo?
- Auto-hospedado: Seus dados ficam nos seus servidores, sob seu controle
- Leve: Roda em um Raspberry Pi ou em um VPS de R$25/mês
- Compatível com Gitea: Substituto drop-in com compatibilidade total de API
- Impulsionado pela comunidade: Governança democrática, sem dependência corporativa
- Compatível com GitHub Actions: Reutilize workflows existentes e actions do marketplace
apt upgrade mantém você sempre na versão mais recente.
📦 Instalação a partir do deb.griffo.io
Passo 1: Adicionar repositório
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe um espelho grátis para sempre. deb-free.griffo.io distribui pacotes grátis para sempre — sem conta, sem assinatura, no máximo 2 meses atrás do upstream, correções de segurança imediatas. Hoje ele traz cliamp, Ghostty, lazydocker, Oh My Posh e Zed; Forgejo não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.
🧩 Sobre a opção extrepo. extrepo é a ferramenta do próprio Debian para repositórios externos: ela escreve o arquivo de sources e instala a chave de assinatura para você, conferindo a chave contra metadados assinados antes de usá-la. Este repositório está registrado nela como griffo, e o espelho gratuito para sempre como griffo-free, então no Debian (bookworm, trixie, forky e sid) os comandos acima são toda a configuração.
O extrepo configura apenas o arquivo de sources e a chave: as credenciais de uma assinatura continuam indo em /etc/apt/auth.conf.d/deb.griffo.io.conf. O Ubuntu não é coberto, porque o extrepo publica metadados só para as suítes do Debian: lá, use os comandos com sudo ou como root.
Passo 2: Instalar Forgejo
# Install latest Forgejo (also installs git and git-lfs)
sudo apt install forgejo
# Verificar instalação
forgejo --version# Install latest Forgejo (also installs git and git-lfs)
apt install forgejo
# Verificar instalação
forgejo --version🚀 Configuração Inicial
O pacote cria automaticamente o usuário de sistema git, o diretório de dados /var/lib/forgejo e o diretório de configuração /etc/forgejo. Conclua a configuração com:
# Start the Forgejo service
sudo systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
sudo systemctl enable forgejo
# Check service status
sudo systemctl status forgejo# Start the Forgejo service
systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
systemctl enable forgejo
# Check service status
systemctl status forgejo🛡️ Hardening de Segurança Pós-Configuração
Após concluir a configuração pela web, torne o arquivo de configuração somente leitura para maior segurança:
# Lock down the config directory and app.ini after initial configuration
sudo systemctl stop forgejo
sudo chmod 750 /etc/forgejo
sudo chmod 640 /etc/forgejo/app.ini
sudo systemctl start forgejo# Lock down the config directory and app.ini after initial configuration
systemctl stop forgejo
chmod 750 /etc/forgejo
chmod 640 /etc/forgejo/app.ini
systemctl start forgejo🔧 Administração por Linha de Comando
O Forgejo fornece uma CLI para tarefas administrativas. Execute os comandos como usuário git:
# List all users
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks# List all users
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks🚀 Por que escolher o deb.griffo.io?
- Debian Oficial: Nenhum pacote Forgejo disponível nos repositórios oficiais
- Instalação manual: Requer download e posicionamento manual do binário
- deb.griffo.io: Última versão com empacotamento adequado, configuração pós-instalação e suporte a apt update
- ✅ Últimos Patches de Segurança: Sempre obtenha a versão mais recente do Forgejo
- ✅ Configuração Automática: Script pós-instalação cria usuário, diretórios e serviço systemd
- ✅ Dependências Corretas: git e git-lfs instalados automaticamente
- ✅ Atualizações Automáticas:
apt upgrademantém o Forgejo atualizado - ✅ Multi-Arquitetura: Suporta amd64, armhf (Raspberry Pi) e arm64
- ✅ Multi-Distribuição: Funciona no Bookworm, Trixie e Sid
📦 Repositório de construção de pacotes
Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:
- ⚒️ forgejo-debian - Latest release builds
🔗 Pacotes relacionados
Também disponível no deb.griffo.io:
- lazygit - Interface de terminal para Git (ótimo companheiro para workflows git)
- lazydocker - Interface de terminal para Docker (útil ao rodar Forgejo em containers)
- eza - Substituto moderno do ls
💝 Apoiar Este Projeto
Se este repositório economiza seu tempo e esforço, considere apoiá-lo!