Resposta rápida: Gitea é um servidor Git self-hosted gratuito, roda com menos de 100 MB de RAM e sobe via Docker. Veja como instalar, migrar do GitHub e usar CI/CD.
Manter repositórios Git fora de plataformas como GitHub ou GitLab.com deixou de ser coisa só de empresa grande. Com o Gitea, um único VPS barato ou até um Raspberry Pi na estante de casa vira um GitHub particular, sem limite artificial de repositórios privados, sem depender de terceiros para decidir o que acontece com o seu código, e sem mensalidade. O projeto nasceu em 2016 como um fork do Gogs justamente para acelerar o desenvolvimento e abrir a governança para mais colaboradores, e hoje é usado por equipes que vão de um desenvolvedor solo até times corporativos que precisam manter o código atrás do próprio firewall por exigência de compliance. A instalação via Docker Compose é praticamente copiar e colar, e a migração de repositórios existentes do GitHub, GitLab ou Bitbucket é assistida por um importador nativo que traz junto issues, labels e milestones.
Atualizado em 21/07/2026
O que é o Gitea e por que ele existe?
O Gitea é uma plataforma de hospedagem de código-fonte self-hosted, escrita em Go, que replica boa parte da experiência do GitHub — repositórios, issues, pull requests, code review, wiki, releases e automação de CI/CD — mas roda inteiramente no seu próprio servidor. Diferente do GitLab Community Edition, que facilmente passa de 2 GB de RAM só para ficar de pé, o Gitea foi construído para ser leve desde a primeira linha de código, rodando confortavelmente em servidores modestos ou dispositivos ARM de baixo custo.
O Gitea funciona no Windows, ou só em servidor Linux?
O Gitea roda nativamente em Linux, Windows e macOS, tanto como binário único quanto via Docker. Para uso pessoal em casa, muita gente sobe o Gitea num container Docker dentro do próprio Windows com o Docker Desktop, ou num servidor Linux barato na nuvem. Quem nunca configurou Docker no Windows pode seguir um passo a passo dedicado antes de partir para o Gitea propriamente dito.
Requisitos e como instalar o Gitea via Docker passo a passo
- Tenha o Docker instalado — em Windows, veja o guia de instalação do Docker passo a passo
- Crie a pasta de dados persistentes, por exemplo /gitea/data
- Rode o container: docker run -d –name gitea -p 3000:3000 -p 222:22 -v /gitea/data:/data gitea/gitea:latest
- Acesse http://localhost:3000 no navegador para o assistente de configuração inicial
- Escolha o banco de dados — SQLite para uso pessoal, PostgreSQL ou MySQL para produção com mais usuários
- Crie a conta de administrador e finalize a configuração
- Configure HTTPS via proxy reverso (Nginx, Caddy ou Traefik) antes de expor o servidor à internet
Gitea Actions substitui o GitHub Actions?
Na maior parte dos casos, sim. O Gitea Actions foi desenhado para ler a mesma sintaxe YAML dos workflows do GitHub Actions, então pipelines existentes de build, teste e deploy costumam funcionar com pouca ou nenhuma alteração. A diferença fica na disponibilidade de actions prontas do marketplace público do GitHub — algumas precisam ser espelhadas manualmente ou substituídas por scripts próprios, já que o Gitea não replica o marketplace inteiro. Para quem já roda testes simples (lint, build, testes unitários, deploy via SSH ou Docker), a migração costuma ser tranquila.
Gitea vs Forgejo: o que mudou e qual escolher em 2026?
Um ponto que qualquer comparação séria precisa mencionar: em 2022 nasceu o Forgejo, inicialmente um “soft fork” do Gitea mantido pela Codeberg, que virou fork completo em 2024 depois que parte da comunidade e dos mantenedores históricos discordou da criação da Gitea Ltd, uma empresa que passou a controlar a marca e os rumos comerciais do projeto. Na prática, hoje existem dois caminhos praticamente irmãos: o Gitea, com governança ligada à empresa, e o Forgejo, mantido por uma fundação sem fins lucrativos e favorito de quem prioriza governança 100% comunitária. As duas bases de código ainda são muito parecidas na interface e nos recursos, e migrar de uma para outra é simples, já que o formato de dados e a estrutura de repositórios seguem compatíveis — vale pesquisar o estado atual de cada projeto antes de decidir, já que essa é uma área que muda rápido e novas funcionalidades aparecem em ambos os lados o tempo todo.
Para que serve o Gitea na prática (casos de uso reais)
- Hospedar repositórios privados de projetos pessoais ou de clientes sem depender de plano pago
- Manter o código-fonte de sistemas internos de empresas atrás do próprio firewall, por exigência de segurança ou compliance
- Servir como espelho (mirror) de repositórios do GitHub para ter um backup independente e rodando
- Rodar CI/CD completo com Gitea Actions sem pagar por minutos de execução
- Centralizar wiki, issues e documentação técnica de um time pequeno num único painel
- Ensinar Git e fluxo de pull request em ambiente de laboratório, sem tocar em contas reais de produção
- Registrar pacotes privados (npm, Docker, Maven, entre outros) usando o registry integrado do Gitea, evitando depender de um serviço externo pago
- Manter um espelho local e rápido de dependências internas para times que trabalham offline ou com internet instável
Vale a pena migrar do GitHub para o Gitea?
| Recurso | Gitea | GitHub | GitLab CE |
|---|---|---|---|
| Hospedagem | Self-hosted | Nuvem (GitHub.com) | Self-hosted |
| RAM típica | ~100 MB | Não se aplica | 2 GB ou mais |
| CI/CD | Gitea Actions | GitHub Actions | GitLab Pipelines |
| Custo | Grátis (paga só o servidor) | Grátis com limites, planos pagos por usuário | Grátis (paga só o servidor) |
| Repositórios privados | Ilimitados | Ilimitados | Ilimitados |
Problemas comuns na instalação do Gitea e como resolver
O erro mais frequente de quem instala o Gitea pela primeira vez é esquecer de expor a porta 22 do container para SSH, o que faz operações de git clone e git push via SSH falharem mesmo com a interface web funcionando normalmente pela porta 3000. Outro ponto de atenção é a permissão da pasta de dados montada como volume: em Linux, o container roda com um usuário interno específico, e se a pasta no host pertencer a outro dono, o Gitea pode falhar ao gravar avatares, anexos ou o próprio banco SQLite. Quem expõe o servidor direto na internet sem proxy reverso também costuma esquecer de configurar o cabeçalho correto de URL pública nas configurações, o que quebra links gerados em notificações e webhooks. Fazer backup regular da pasta de dados junto com um dump do banco, antes de qualquer atualização de versão maior, evita boa parte dos sustos.
Quando o Gitea não é a ferramenta certa
Se a sua prioridade é zero manutenção de servidor, o GitHub ou GitLab.com hospedado continuam mais convenientes — no Gitea, você é responsável por atualizações, backup e segurança do próprio servidor. Times que dependem do enorme marketplace de integrações e actions prontas do GitHub também sentirão falta dessa variedade. Projetos que precisam de recursos corporativos avançados de nível enterprise, como auditoria compliance extensa, SSO federado complexo em larga escala ou suporte comercial com SLA, tendem a se encaixar melhor em GitHub Enterprise ou GitLab Ultimate. E se você não tem nenhum servidor ou VPS disponível e não quer gerenciar infraestrutura, o self-hosting em si já é o obstáculo, independente da ferramenta escolhida.
Gitea é seguro? Onde baixar e atualizar sem risco
Baixe sempre a imagem oficial gitea/gitea no Docker Hub ou o binário assinado na página de releases do repositório go-gitea/gitea no GitHub. Mantenha o servidor atualizado — como qualquer software exposto à internet, versões desatualizadas acumulam vulnerabilidades conhecidas. Configure HTTPS com certificado válido, restrinja o registro público de novos usuários se o servidor for privado, e faça backup regular da pasta de dados e do banco de dados antes de qualquer atualização maior.
O Gitea é compatível com GitHub Actions?
Sim, o Gitea Actions lê a mesma sintaxe YAML dos workflows do GitHub Actions, permitindo reaproveitar a maior parte dos pipelines existentes com pouca adaptação.
Posso migrar meus repositórios do GitHub para o Gitea?
Sim, o Gitea tem um importador integrado que migra repositórios, issues, labels e milestones diretamente do GitHub, GitLab e Bitbucket em poucos cliques.
O Gitea roda em Raspberry Pi?
Sim, é leve o suficiente para rodar em um Raspberry Pi com poucos recursos, consumindo tipicamente menos de 100 MB de RAM em uso normal com poucos usuários.
Qual a diferença entre Gitea e Forgejo?
O Forgejo é um fork do Gitea criado por divergências de governança, mantido por uma fundação sem fins lucrativos. As interfaces são parecidas hoje, mas os projetos evoluem de forma independente.
Preciso saber Docker para instalar o Gitea?
Ajuda muito, mas não é obrigatório — existe também o binário nativo para Windows, Linux e macOS. Ainda assim, o Docker é o caminho mais rápido e mais fácil de manter atualizado.
Veredicto: o Gitea vale a pena em 2026?
Para quem quer controle total sobre o próprio código sem gastar nada além do servidor, o Gitea continua sendo a opção mais equilibrada entre leveza, recursos e facilidade de instalação. Ele não tenta ser um GitLab completo com dezenas de módulos corporativos, e essa simplicidade é justamente o ponto forte: sobe rápido, consome pouco e cobre o que 90% dos times realmente usam no dia a dia. Depois de instalado, vale complementar o fluxo com um cliente de terminal como o Lazygit para navegar commits mais rápido, e considerar hospedar também seus próprios arquivos com o Nextcloud no mesmo servidor, fechando um ecossistema pessoal de nuvem privada sem mensalidade.
Receba os melhores programas GRÁTIS por e-mail — 1 e-mail/semana
Software gratuito, open-source e alternativas legais a programas pagos. Sem spam, sem pirataria. Cancela quando quiser. Ao assinar você ganha nosso Kit Essencial: 30 Programas Grátis que Substituem Software Pago.
2 Comentários