Git auto-hospedado com Gitea num VPS - instalação com Docker…

Rode seu próprio servidor Git estilo GitHub com Gitea, PostgreSQL e HTTPS num VPS de 12 €: docker compose, reverse proxy Caddy, acesso SSH para git push e backups.

O Gitea é um serviço Git leve com issues, pull requests e hooks de CI - tudo o que espera, a correr em algumas centenas de megabytes. Num VPS de 16 € serve uma equipa inteira.

1. Instale o Docker

apt update && apt install -y docker.io docker-compose-v2 git
systemctl enable --now docker

Passo a passo completo, incluindo noções básicas do Compose: guia do Docker.

2. O ficheiro Compose

mkdir -p /opt/gitea && cd /opt/gitea
cat > docker-compose.yml <<'EOF'
services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: gitea
      POSTGRES_PASSWORD: change-me-db
      POSTGRES_DB: gitea
    volumes:
      - ./db:/var/lib/postgresql/data
  gitea:
    image: gitea/gitea:1
    restart: unless-stopped
    depends_on: [db]
    environment:
      GITEA__database__DB_TYPE: postgres
      GITEA__database__HOST: db:5432
      GITEA__database__NAME: gitea
      GITEA__database__USER: gitea
      GITEA__database__PASSWD: change-me-db
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "127.0.0.1:3000:3000"
      - "2222:22"
EOF
docker compose up -d

Repare nas ligações: a interface web escuta apenas em localhost, enquanto o SSH para `git push` está na porta 2222. Torne a porta acessível - abrindo a 2222 na firewall ou servindo o Git mais tarde por HTTPS.

3. HTTPS com Caddy

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
git.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy

O Caddy obtém o certificado automaticamente. Aponte primeiro o registo A do domínio para o servidor e conclua o assistente de configuração no navegador - a primeira conta registada torna-se o administrador.

4. Envie o código

git remote add origin ssh://[email protected]:2222/you/project.git
git push -u origin main

Adicione a sua chave pública nas definições do Gitea uma só vez e todos os pushes seguintes ficam sem palavra-passe.

5. Cópias de segurança que realmente se restauram

docker compose exec -u git gitea gitea dump -c /data/gitea/conf/app.ini
# the dump lands in /opt/gitea/data/gitea, then ship it off-site:
restic backup /opt/gitea/data --exclude-caches

O comando `gitea dump` reúne a base de dados, os repositórios e a configuração num único arquivo. Para cópias fora do servidor, veja o guia do restic.

Respostas rápidas

De quanta RAM precisa o Gitea?

O contentor em repouso usa cerca de 150–250 MB e o PostgreSQL mais 100–200 MB. Um servidor de 2 GB é confortável para uma equipa pequena; 4 GB se também executar runners de CI ou muitos repositórios grandes.

Posso importar repositórios do GitHub?

Sim. No Gitea escolha Nova migração, cole o URL do repositório e ele copia o código, as issues e os pull requests. Os repositórios privados precisam de um token de acesso do GitHub.

O meu código está seguro num VPS?

É tão seguro quanto a administração do seu servidor: chaves SSH, firewall, atualizações e cópias fora do servidor cobrem os riscos realistas. Para muitas equipas, isso é mais controlo do que confiar tudo a terceiros.

O Gitea e o PostgreSQL cabem com folga num Core VPS 6 (16 €/mês).

Relacionados

Ver planosGuiasFAQ