Forgejo vs Gitea en Proxmox LXC: ¿qué plataforma de Git autoalojada usar en 2026?
Self-hosting

Forgejo vs Gitea en Proxmox LXC: ¿qué plataforma de Git autoalojada usar en 2026?

Ricardo Gil
12 de octubre de 2026
10 min de lectura

Traducido del original en inglés. Read this article in English →

#Forgejo #Gitea #Proxmox #Self-Hosting #Home Lab #Git #LXC #2026
🛒

Productos en este artículo

Enlaces de afiliado

Como Afiliado de Amazon, gano comisiones por compras que califican, sin costo extra para ti.

Si llevas más de seis meses con un homelab, casi seguro te preguntaste: ¿debería autoalojar mi propio servidor de Git? Y cuando decides que sí, aparece de inmediato la siguiente pregunta: ¿Forgejo o Gitea?

Ambos son alternativas livianas a GitHub escritas en Go que corren cómodamente dentro de un contenedor LXC de Proxmox. Ambos traen registro de contenedores, CI/CD con runners compatibles con Actions y una interfaz tipo GitHub que tu equipo ya entiende. Y ambos te quitan las ganas de tener Git propio sin exigir un servidor dedicado ni 8 GB de RAM.

Pero ya no son el mismo proyecto, y en 2026 la distancia entre ellos importa más que cuando se separaron. Esta guía cubre todo: gobernanza, funciones, consumo de recursos, instalación en Proxmox LXC y cuál deberías elegir.

¿Por qué autoalojar Git?

Antes de comparar: si tienes un homelab o un equipo pequeño y todavía subes todo a GitHub o GitLab.com, estás regalando datos, dependiendo de la disponibilidad de otro y pagando por repos privados que podrías controlar tú.

Autoalojar tu servidor de Git te da:

  • Propiedad total de tu código, issues, logs de CI y paquetes: sin cambios de términos de servicio ni cuentas suspendidas
  • Runners de CI/CD privados en tu propio hardware (importante si tus builds usan dependencias propietarias o necesitan GPU)
  • Repos privados ilimitados sin licencias por usuario
  • Registro de contenedores junto a tu código: compilas, publicas y descargas sin chocar con los límites de Docker Hub

Para un ingeniero con homelab y Proxmox, es una victoria fácil. Un contenedor LXC con 1 vCPU y 512 MB de RAM es realmente todo lo que necesitas.

El fork: qué pasó realmente entre Forgejo y Gitea

Forgejo se separó de Gitea a finales de 2022. La división no fue técnica, sino de gobernanza. Un grupo de colaboradores principales se preocupó porque Gitea Ltd (la empresa detrás de Gitea) estaba acumulando demasiado control sobre un proyecto que se había vuelto infraestructura crítica para miles de personas que autoalojan.

Forgejo nació con un modelo de gobernanza sin fines de lucro y un objetivo explícito: el proyecto pertenece a sus usuarios, no a una empresa. El código está alojado en Codeberg, las decisiones pasan por una estructura comunitaria y la marca está protegida para que no pueda apropiarse comercialmente.

Gitea, mientras tanto, siguió avanzando bajo la dirección de Gitea Ltd. La empresa ha invertido más en funciones empresariales, hosting en la nube (gitea.com) y soporte comercial, lo que significa más velocidad en algunas áreas, pero también una hoja de ruta definida por clientes empresariales que pagan, no por quienes autoalojan.

En la práctica, ambos códigos comparten una base común grande y la API sigue siendo compatible. Puedes migrar de uno a otro en una tarde.

Comparación de funciones: Forgejo vs Gitea en 2026

CI/CD: runners de Actions

Ambas plataformas traen un sistema de CI compatible con GitHub Actions. Gitea lo llama Gitea Actions y Forgejo, Forgejo Actions. La sintaxis es idéntica: tus archivos .github/workflows/*.yml existentes funcionan con cambios menores de rutas.

En 2026, Forgejo avanzó de forma más agresiva hacia la compatibilidad total con Actions, corrigiendo varios casos borde que Gitea no ha resuelto. Si migras pipelines complejos desde GitHub, Forgejo suele ser el aterrizaje más suave.

Ganador en CI/CD: Forgejo (por poco)

Registro de paquetes y contenedores

Ambos traen un registro de paquetes integrado con soporte para NuGet, npm, PyPI, Maven e imágenes de contenedores (OCI). Es la función estrella que hace que el Git autoalojado sea realmente útil para todo el flujo de desarrollo: tu CI compila una imagen, la publica en el mismo servidor donde vive tu código y tu clúster de Kubernetes la descarga directamente.

En 2026 ninguna de las dos plataformas tiene ventaja real aquí. Ambas simplemente funcionan.

Pull requests federados (solo Forgejo)

Aquí es donde Forgejo está innovando de verdad. El equipo está construyendo federación basada en ActivityPub: la posibilidad de abrir un pull request en una instancia de Forgejo desde otra instancia de Forgejo, sin crear una cuenta en el servidor de destino. Piénsalo como el correo electrónico, pero para revisiones de código.

En 2026 todavía es experimental, pero es el tipo de función que solo construye un proyecto gobernado por su comunidad. Gitea Ltd no tiene incentivos para federar: la federación amenaza la dependencia de los usuarios con gitea.com.

Para un homelab personal no importa hoy. Para quien contribuye a proyectos open source públicos o los administra, es el futuro.

Interfaz y experiencia móvil

Las interfaces son casi idénticas (la de Forgejo es un fork de la de Gitea), así que la curva de aprendizaje es cero si ya usaste cualquiera de las dos. En 2026 Forgejo hizo mejoras de interfaz algo más ambiciosas, incluido un mejor modo oscuro y una vista de diffs rediseñada.

Ninguno tiene app móvil nativa. La interfaz web funciona en el móvil, pero no está optimizada.

Consumo de recursos en Proxmox LXC

Esto es lo que realmente te importa al dimensionar tu contenedor LXC:

Forgejo Gitea
RAM en reposo (sin carga) ~420 MB ~400 MB
RAM con carga de CI ~600-800 MB ~580-750 MB
Disco (binario + datos) ~150 MB base ~140 MB base
RAM recomendada para el LXC 1 GB (mín. 512 MB) 1 GB (mín. 512 MB)
CPU en reposo <1% <1%

La diferencia es insignificante. Si le asignas 1 GB de RAM al contenedor, ambos funcionan igual. El binario de Forgejo es un poco más grande por el código de federación, pero nunca lo vas a notar.

Especificación de LXC recomendada para cualquiera de las dos:

  • CPU: 1-2 vCPU
  • RAM: 1024 MB (2048 MB si corres runners de Actions en el mismo contenedor)
  • Disco: 20-50 GB (según cuántos repos y paquetes vayas a guardar)
  • Plantilla: Ubuntu 22.04 o Debian 12

Instala Forgejo en Proxmox LXC (paso a paso)

Esto asume que tienes un nodo de Proxmox con almacenamiento para plantillas LXC. Si no lo tienes configurado, descarga primero la plantilla de Debian 12:

bash
pveam update
pveam download local debian-12-standard_12.7-1_amd64.tar.zst

1. Crea el contenedor LXC

En la interfaz de Proxmox: Create CT y configura 1024 MB de RAM, 20 GB de disco, 1 núcleo de CPU, contenedor sin privilegios y red en bridge con IP fija.

O por CLI:

bash
pct create 120 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \
  --hostname forgejo \
  --memory 1024 \
  --cores 1 \
  --rootfs local-lvm:20 \
  --net0 name=eth0,bridge=vmbr0,ip=192.168.1.120/24,gw=192.168.1.1 \
  --unprivileged 1 \
  --start 1

2. Instala Forgejo

bash
pct exec 120 -- bash -c "
apt update && apt install -y git curl
useradd -m -s /bin/bash git
cd /home/git
curl -fsSL https://codeberg.org/forgejo/forgejo/releases/download/v9.0.3/forgejo-9.0.3-linux-amd64 -o forgejo
chmod +x forgejo
mkdir -p /var/lib/forgejo /etc/forgejo
chown -R git:git /var/lib/forgejo /etc/forgejo
"

Revisa siempre codeberg.org/forgejo/forgejo/releases para usar la última versión; la v9.x es la actual a mediados de 2026.

3. Crea un servicio de systemd

bash
pct exec 120 -- bash << 'HEREDOC'
cat > /etc/systemd/system/forgejo.service << 'EOF'
[Unit]
Description=Forgejo
After=network.target

[Service]
RestartSec=2s
Type=simple
User=git
WorkingDirectory=/var/lib/forgejo
ExecStart=/home/git/forgejo web --config /etc/forgejo/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/forgejo

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now forgejo
HEREDOC

4. Completa la configuración web

Entra a http://192.168.1.120:3000 y completa el asistente de configuración inicial. Ajustes clave:

  • Base de datos: SQLite está bien para uso personal o equipos pequeños; PostgreSQL si esperas mucha carga o muchos trabajos de CI simultáneos
  • Puerto SSH: 22 (o uno personalizado si el host LXC usa el 22 para el propio nodo de Proxmox)
  • Usuario de ejecución: git
  • Cuenta de administrador: crea aquí tu usuario administrador inicial; no te saltes este paso

5. Proxy inverso con Caddy

Si ya corres Caddy en tu red de Proxmox, agrega un bloque de proxy a tu Caddyfile:

code
git.yourdomain.com {
  reverse_proxy 192.168.1.120:3000
}

Forgejo detecta automáticamente la URL externa si defines ROOT_URL en /etc/forgejo/app.ini:

ini
[server]
ROOT_URL = https://git.yourdomain.com/

Migrar de GitHub a Forgejo o Gitea

Ambas plataformas permiten migrar repos de GitHub con un clic, incluidos issues, PRs, etiquetas, hitos y wikis. Ve a + > New Migration > GitHub e ingresa tu token de GitHub. La migración corre en segundo plano y ves un indicador de progreso.

Para migrar entre Gitea y Forgejo, ambos soportan exportaciones en formato Gitea:

  1. En el origen: usa la exportación del panel de administración o la API (/api/v1/repos/search para la lista completa)
  2. En el destino: importa con el asistente de migración eligiendo "Gitea" como origen
  3. Las llaves SSH, los webhooks y los secretos de Actions hay que volver a agregarlos a mano

Hardware que vale la pena para tu setup de Git + CI

Si vas a correr runners de Actions en el mismo nodo de Proxmox, necesitas RAM y almacenamiento NVMe suficientes para builds simultáneos.

Para un nodo dedicado de Git/CI, el Minisforum MS-01 es excelente: i9-12900H, soporta hasta 96 GB de DDR5, dos NICs de 2.5G y maneja Proxmox más varios contenedores LXC sin esfuerzo. El Beelink EQR6 es una opción más barata con Ryzen 9 6900HX, 32 GB de DDR5 y NVMe de 500 GB: muy buen valor para un mini PC dedicado al homelab. Si quieres algo encendido 24/7 con bajo consumo y un presupuesto más ajustado, el Beelink SER6 Pro cumple.

Para el almacenamiento, el NVMe WD Red SN700 de 1 TB está hecho para cargas siempre encendidas y es excelente como almacenamiento local de Proxmox. Para la máxima velocidad en la caché de builds, el Samsung 990 Pro de 2 TB es difícil de superar. El Sabrent Rocket 4 Plus de 1 TB es una alternativa sólida con muy buen rendimiento de lectura/escritura aleatoria para cachés de artefactos.

En red, el TP-Link TL-SG108E es un switch administrable GbE de 8 puertos con VLANs, barato y muy confiable. Para el enrutamiento del borde de tu homelab, el MikroTik hEX S, con 5 puertos GbE más un puerto SFP, es difícil de superar por su precio. Y para nodos de Proxmox sin pantalla, un PiKVM V4 Plus vale cada centavo el día que rompes el gestor de arranque a las 2 de la mañana. El cable DAC SFP+ de 10GbE de Cable Matters es la opción correcta para conectar directamente nodos de Proxmox y switches administrables.

¿Cuál elegir en 2026?

Este es el veredicto honesto.

Elige Forgejo si te importan la gobernanza y la libertad del software (deberían), quieres el CI más compatible con GitHub Actions, te interesan las funciones de federación a medida que maduren o quieres contribuir: Forgejo acepta contribuciones de forma más abierta y su comunidad es más accesible.

Elige Gitea si tu equipo ya tiene experiencia con Gitea y ninguna razón para migrar, necesitas contratos de soporte empresarial o quieres la mayor alineación con la plataforma comercial gitea.com.

Para un homelab personal en 2026: elige Forgejo. El modelo de gobernanza es mejor, la compatibilidad con Actions es mejor y apoyas un proyecto que realmente pertenece a su comunidad. El consumo de recursos es idéntico y el costo de migrar desde Gitea es mínimo.

Ambos son muchísimo mejores que GitLab CE si tienes recursos limitados: GitLab CE necesita 4 GB o más de RAM para funcionar de forma confiable, 4 veces más, para un conjunto de funciones del que la mayoría de los homelabbers usa quizás el 20%.

Checklist final

Antes de dar tu instancia por lista para producción:

  • Certificado SSL con un proxy inverso (Caddy o Nginx Proxy Manager)
  • SMTP configurado para el registro de cuentas y las notificaciones de PRs
  • Respaldos automáticos: vuelca la base SQLite o PostgreSQL a tu NAS cada noche
  • Llave SSH agregada a tu cuenta y probada con ssh -T git@git.yourdomain.com
  • Runner de Actions configurado si quieres CI/CD
  • Pipeline de prueba en .gitea/workflows/ pasando (Forgejo también lee esa ruta)
  • Registro de usuarios desactivado o con aprobación del administrador si tu instancia está expuesta a internet
  • Acceso con Tailscale o WireGuard si quieres hacer push desde fuera de casa sin exponer puertos públicamente

El Git autoalojado es de esas decisiones de homelab que tomas una vez y no vuelves a pensar: simplemente funciona. Forgejo y Gitea se ganan esa reputación. En 2026, Forgejo se la gana con mejores principios detrás.

Aviso: este artículo contiene enlaces de afiliado. Si compras a través de ellos, puedo ganar una pequeña comisión sin costo extra para ti.

¿Quieres algo así para tu negocio?

Instalo infraestructura privada y autoalojada en Proxmox: IA, automatización y herramientas internas en hardware que es tuyo, documentado y entregado. Ver el stack de IA privada →

¿No sabes qué necesitas? Agenda una llamada gratis.

📬Newsletter semanal

Recibe lo mejor de homelab e IA

Sin spam. Un correo por semana. Te das de baja cuando quieras.

Comparte este artículo