¿Qué es Forgejo?
Forgejo es una forja de software ligera y autoalojada. Fácil de instalar y con poco mantenimiento, simplemente hace el trabajo. Forgejo es un fork de Gitea impulsado por la comunidad, centrado en la seguridad, la privacidad y la gobernanza democrática — ofreciéndote una alternativa autoalojada a GitHub o GitLab que controlas completamente.
⚡ Características clave de Forgejo
📦 Alojamiento de repositorios Git
Aloja repositorios git públicos y privados sin límite. Soporte completo para Git LFS, almacenamiento de archivos grandes y duplicación de repositorios desde GitHub, GitLab y más.
🔄 Pull Requests y revisión de código
Flujo de trabajo de pull requests integrado con revisión de código en línea, asignación de revisores, revisores requeridos y estrategias de fusión incluyendo squash y rebase.
🐛 Seguimiento de problemas
Rastreador de problemas completo con etiquetas, hitos, tablero de proyectos, campos personalizados y referencias entre repositorios.
⚙️ Forgejo Actions
Motor CI/CD integrado compatible con los flujos de trabajo de GitHub Actions. Usa acciones existentes del marketplace de GitHub Actions en tu runner autoalojado.
📚 Registro de paquetes
Aloja tus propios paquetes: npm, PyPI, Maven, imágenes Docker/OCI, paquetes Debian/RPM, charts de Helm y más — todo en un solo lugar.
🔐 Seguridad y control de acceso
Permisos granulares, autenticación de dos factores, proveedor OAuth2, integración LDAP/SAML, acceso por SSH y HTTPS, reglas de protección de ramas.
🏆 ¿Por qué Forgejo?
- Autoalojado: Tus datos permanecen en tus servidores, bajo tu control
- Ligero: Funciona en una Raspberry Pi o un VPS de 5 $/mes
- Compatible con Gitea: Reemplazo directo con compatibilidad total de API
- Impulsado por la comunidad: Gobernanza democrática, sin dependencia corporativa
- Compatible con GitHub Actions: Reutiliza flujos de trabajo y acciones del marketplace existentes
apt upgrade te mantiene siempre en la última versión.
📦 Instalación desde deb.griffo.io
Paso 1: Agregar repositorio
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe un espejo gratis para siempre. deb-free.griffo.io sirve paquetes gratis para siempre: sin cuenta, sin suscripción, como máximo 2 meses por detrás del upstream, correcciones de seguridad inmediatas. Ahora mismo incluye cliamp, Ghostty, lazydocker, Oh My Posh y Zed; Forgejo no está entre ellas, así que hoy el repositorio de arriba es la única forma de instalarlo — pídelo y puede añadirse.
🧩 Sobre la opción extrepo. extrepo es la herramienta propia de Debian para repositorios externos: escribe el archivo de sources e instala la clave de firma por ti, comprobándola antes contra metadatos firmados. Este repositorio está registrado en ella como griffo, y el espejo gratuito para siempre como griffo-free, así que en Debian (bookworm, trixie, forky y sid) los comandos de arriba son toda la configuración.
extrepo solo configura el archivo de sources y la clave: las credenciales de una suscripción siguen yendo en /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu no está cubierto, porque extrepo publica metadatos solo para las suites de Debian: allí usa los comandos con sudo o como root.
Paso 2: Instalar Forgejo
# Install latest Forgejo (also installs git and git-lfs)
sudo apt install forgejo
# Verify installation
forgejo --version# Install latest Forgejo (also installs git and git-lfs)
apt install forgejo
# Verify installation
forgejo --version🚀 Configuración inicial
El paquete crea automáticamente el usuario del sistema git, el directorio de datos /var/lib/forgejo y el directorio de configuración /etc/forgejo. Completa la configuración con:
# Start the Forgejo service
sudo systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
sudo systemctl enable forgejo
# Check service status
sudo systemctl status forgejo# Start the Forgejo service
systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
systemctl enable forgejo
# Check service status
systemctl status forgejo🛡️ Endurecimiento de seguridad tras la configuración
Tras completar la configuración mediante la interfaz web, haz el archivo de configuración de solo lectura para mayor seguridad:
# Lock down the config directory and app.ini after initial configuration
sudo systemctl stop forgejo
sudo chmod 750 /etc/forgejo
sudo chmod 640 /etc/forgejo/app.ini
sudo systemctl start forgejo# Lock down the config directory and app.ini after initial configuration
systemctl stop forgejo
chmod 750 /etc/forgejo
chmod 640 /etc/forgejo/app.ini
systemctl start forgejo🔧 Administración por línea de comandos
Forgejo proporciona una CLI para tareas de administración. Ejecuta los comandos como el usuario git:
# List all users
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks# List all users
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial: No hay paquete de Forgejo disponible en los repositorios oficiales
- Instalación manual: Requiere descargar y colocar el binario manualmente
- deb.griffo.io: Última versión con empaquetado adecuado, configuración postinst y soporte para apt update
- ✅ Últimos parches de seguridad: Obtén siempre la versión más reciente de Forgejo
- ✅ Configuración automática: El script postinst crea usuario, directorios y servicio systemd
- ✅ Dependencias correctas: git y git-lfs se instalan automáticamente
- ✅ Actualizaciones automáticas:
apt upgrademantiene Forgejo actualizado - ✅ Multi-arquitectura: Compatible con amd64, armhf (Raspberry Pi) y arm64
- ✅ Multi-distribución: Funciona en Bookworm, Trixie y Sid
📦 Repositorio de construcción de paquetes
Los paquetes de Debian se construyen y mantienen automáticamente en este repositorio de GitHub:
- ⚒️ forgejo-debian - Latest release builds
🔗 Paquetes relacionados
También disponible desde deb.griffo.io:
- lazygit - Terminal UI para Git (gran complemento para flujos de trabajo con git)
- lazydocker - Terminal UI para Docker (útil si ejecutas Forgejo en contenedores)
- eza - Reemplazo moderno de ls
💝 Apoyar este proyecto
¡Si este repositorio te ahorra tiempo y esfuerzo, considera apoyarlo!