Admin-Sistemas ·

Forgejo: monta tu propio servidor Git sin depender de GitHub

GitHub se cae, una cuenta se bloquea o un cambio de condiciones te deja fuera de tus propios repositorios. Si tu código es tu trabajo, depender de una forja ajena es un riesgo que no necesitas asumir: Forgejo es el fork comunitario de Gitea, gobernado por la asociación sin ánimo de lucro Codeberg e.V., y te da repositorios, incidencias, pull requests, wiki y CI en un solo binario de Go que corre hasta en una Raspberry Pi. Sin suscripciones, sin telemetría y con tus datos en tu disco.

En esta guía lo instalamos en Debian/Ubuntu con systemd, lo ponemos detrás de nginx con HTTPS y lo dejamos cerrado: solo tú creas cuentas.

Requisitos

Un VPS o máquina con Debian/Ubuntu, 1 vCPU, 512 MB de RAM y 10 GB de disco bastan para un uso personal o de equipo pequeño. Forgejo usa SQLite por defecto, así que no hace falta base de datos externa. Necesitas un dominio (por ejemplo, git.tudominio.com) apuntando al servidor.

1. Preparar el sistema

Forgejo corre como un usuario propio, git, y guarda los repositorios en /var/lib/forgejo y la configuración en /etc/forgejo:

sudo apt update && sudo apt install -y git git-lfs
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
  --group --disabled-password --home /home/git git
sudo mkdir -p /var/lib/forgejo /etc/forgejo
sudo chown -R git:git /var/lib/forgejo /etc/forgejo
sudo chmod 750 /etc/forgejo

git-lfs es necesario si quieres soporte para ficheros grandes; sin él, Forgejo avisa en los registros cada vez que un clon lo necesita.

2. Descargar y verificar el binario

La versión estable actual es la 17.0.2, publicada el 18 de noviembre de 2026 (con soporte hasta el 28 de enero de 2027). Si prefieres actualizaciones solo de seguridad, la rama LTS es la 15.x. Descarga el binario y comprueba la firma GPG del proyecto antes de instalarlo:

cd /tmp
curl -fsSL -O https://codeberg.org/forgejo/forgejo/releases/download/v17.0.2/forgejo-17.0.2-linux-amd64
curl -fsSL -O https://codeberg.org/forgejo/forgejo/releases/download/v17.0.2/forgejo-17.0.2-linux-amd64.asc
gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710
gpg --verify forgejo-17.0.2-linux-amd64.asc forgejo-17.0.2-linux-amd64
sudo install -m 755 forgejo-17.0.2-linux-amd64 /usr/local/bin/forgejo
forgejo --version

La salida de gpg --verify debe decir Good signature; si no, no instales ese binario. Consulta siempre la última versión en forgejo.org/releases antes de copiar el número de versión a ciegas.

3. Servicio systemd

El proyecto publica su propia unidad de systemd. Descárgala, actívala y comprueba que escucha en el puerto 3000:

sudo curl -fsSL -o /etc/systemd/system/forgejo.service \
  https://codeberg.org/forgejo/forgejo/raw/branch/forgejo/contrib/systemd/forgejo.service
sudo systemctl daemon-reload
sudo systemctl enable --now forgejo
sudo systemctl status forgejo --no-pager
sudo ss -tlnp | grep 3000

La unidad arranca /usr/local/bin/forgejo web --config /etc/forgejo/app.ini como usuario git y reinicia el proceso sola si se cae (Restart=always).

4. Primera configuración y cierre del registro

Abre http://IP-del-servidor:3000 y completa el instalador web: deja SQLite, pon el título del sitio y crea la cuenta de administrador. En cuanto entres, cierra la puerta: edita /etc/forgejo/app.ini y añade bajo [service]:

[service]
DISABLE_REGISTRATION = true
REQUIRE_SIGNIN_VIEW  = true
DEFAULT_KEEP_EMAIL_PRIVATE = true
sudo systemctl restart forgejo

Con esto nadie puede registrarse por su cuenta ni ver tus repositorios sin iniciar sesión. Activa además el segundo factor (TOTP) en tu cuenta de administrador desde Mis ajustes → Seguridad: es el mismo mecanismo que en cualquier forja seria y tarda un minuto.

Panel de Forgejo con repositorios, incidencias y pull requests en una instancia autoalojada

5. Detrás de nginx con HTTPS

No expongas el puerto 3000 a internet: pon nginx delante como proxy inverso. En el bloque server de tu dominio:

location / {
    proxy_pass http://127.0.0.1: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;
}

Y emite el certificado con sudo certbot --nginx -d git.tudominio.com. Si aún no tienes certbot configurado, sigue la guía de Certbot y Let’s Encrypt: HTTPS automático en nginx; y si quieres endurecer ese nginx, la de nginx blindado con ModSecurity y rate limiting.

6. Tu primer repositorio

Crea el repositorio desde la web y sube tu clave SSH pública en Mis ajustes → Claves SSH/GPG. Comprueba el acceso:

ssh -T git@git.tudominio.com

Forgejo responde con un saludo y el nombre de tu clave. Después, el flujo es el Git de siempre:

git clone git@git.tudominio.com:oscar/mi-proyecto.git
cd mi-proyecto
# ... trabaja ...
git push origin main

O empuja un repositorio local existente con git remote add origin git@git.tudominio.com:oscar/mi-proyecto.git y git push -u origin main.

Checklist para que dure

Tarea Cómo
Actualizar Forgejo Sustituir el binario por la nueva versión y systemctl restart forgejo
Copias de seguridad Respaldar /var/lib/forgejo y /etc/forgejo/app.ini a diario
Cuentas Registro cerrado, 2FA en el admin, revisa los usuarios cada mes
Limpieza forgejo admin doctor y la tarea programada de cron del propio panel

Para las copias, el esquema de retención GFS de BorgBackup encaja perfecto: los datos de Forgejo son pocos ficheros que cambian a diario y se deduplican muy bien.

Forgejo no pretende sustituir a GitHub para colaborar con el mundo, pero para tu código, tus notas y tus scripts es difícil pedir más: un binario, una base de datos y cero dependencia de terceros. Y cuando quieras CI, el siguiente paso natural son las Forgejo Actions, compatibles con la sintaxis de GitHub Actions, sin salir de tu servidor.