Gitea en un VPS - Git autoalojado con Docker

Ejecuta tu propio servidor Git estilo GitHub con Gitea, PostgreSQL y HTTPS en un VPS de 12 €: docker compose, reverse proxy Caddy, acceso SSH para git push y copias de seguridad.

Gitea es un servicio Git ligero con issues, pull requests y ganchos de CI - todo lo que espera, ejecutándose en unos pocos cientos de megabytes. En un VPS de €16 da servicio a un equipo entero.

1. Instale Docker

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

Guía completa, incluidos los conceptos básicos de Compose: guía de Docker.

2. Archivo de 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

Observe los enlaces (bindings): la interfaz web solo escucha en localhost, mientras que el SSH para `git push` está en el puerto 2222. Haga el puerto accesible - abra el 2222 en el firewall o sirva Git más adelante mediante HTTPS.

3. HTTPS con Caddy

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

Caddy obtiene un certificado automáticamente. Apunte primero el registro A del dominio al servidor y complete el asistente de configuración en el navegador - la primera cuenta que registre se convierte en la administradora.

4. Suba el código

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

Añada su clave pública una vez en la configuración de Gitea y cada push posterior será sin contraseña.

5. Copias de seguridad que realmente se restauran

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

El comando `gitea dump` empaqueta la base de datos, los repositorios y la configuración en un solo archivo. Copias fuera del servidor: vea la guía de restic.

Respuestas rápidas

¿Cuánta RAM necesita Gitea?

El contenedor consume en reposo unos 150–250 MB, PostgreSQL otros 100–200 MB. Un servidor de 2 GB es cómodo para un equipo pequeño; 4 GB si también ejecuta runners de CI o muchos repositorios grandes.

¿Puedo importar repositorios de GitHub?

Sí. En Gitea elija New Migration, pegue la URL del repositorio y copiará el código, los issues y los pull requests. Los repositorios privados necesitan un token de acceso de GitHub.

¿Es seguro mi código en un VPS?

Es tan seguro como su administración del servidor: las claves SSH, el firewall, las actualizaciones y los volcados fuera del servidor cubren los riesgos reales. Para muchos equipos eso es más control que confiarlo todo a un tercero.

Gitea más PostgreSQL caben en Core VPS 6 (€16/mes) con margen de sobra.

Relacionado

Ver planesGuíasFAQ