¿Qué es Forgejo Runner?
Forgejo Runner es el runner de CI para Forgejo Actions. Es un daemon ligero que se conecta a tu instancia de Forgejo, recoge los trabajos de workflow en cola y los ejecuta en tu propia infraestructura — usando Docker, LXC o directamente el host — dándote un pipeline de CI/CD totalmente autoalojado y compatible con GitHub Actions.
⚡ Características clave de Forgejo Runner
🔁 Compatible con Actions
Ejecuta workflows usando la misma sintaxis y ecosistema de acciones que GitHub Actions.
🐳 Ejecución flexible
Ejecuta trabajos en contenedores Docker, LXC o directamente en la máquina host.
🔐 Autoalojado
Mantén todo tu CI/CD en tu propia infraestructura, sin dependencia de terceros.
⚖️ Escalable
Registra varios runners con etiquetas para distribuir y dirigir las cargas de trabajo.
🎯 ¿Por qué Forgejo Runner?
- Controla tu CI: Ejecuta pipelines en hardware que tú controlas
- Ecosistema de Actions: Reutiliza definiciones de workflow existentes al estilo GitHub
- Aislamiento flexible: Ejecución en Docker, LXC o host según tus necesidades
- Ligero: Un único binario de Go, sencillo de desplegar
🆕 Aspectos destacados
- Ejecución de trabajos: Ejecuta los workflows en cola de Forgejo Actions
- Etiquetas: Dirige trabajos a runners específicos
- Soporte de contenedores: Compilaciones aisladas mediante Docker
- Modo daemon: Se ejecuta continuamente como servicio
📦 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 Runner 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-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verify installation
forgejo-runner --version# Install latest forgejo-runner
apt install forgejo-runner
# Verify installation
forgejo-runner --version🎯 Ejemplos de uso básico
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>
# Start the runner daemon
forgejo-runner daemon🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial: A menudo meses por detrás, sin las últimas funciones
- deb.griffo.io: Última versión pocas horas después de su lanzamiento
- Instalación manual: Requiere descargas manuales y configuración del PATH
- Nuestro repositorio: Paquetes precompilados y listos para usar
- ✅ Últimas funciones: Obtén las funciones y mejoras más recientes de Forgejo Runner de inmediato
- ✅ Sin configuración manual: Binarios precompilados, instalados y actualizados mediante apt
- ✅ Actualizaciones automáticas: Paquetes actualizados pocas horas después de los lanzamientos oficiales
- ✅ Dependencias correctas: Correctamente empaquetado con todas las bibliotecas necesarias
- ✅ Multi-distribución: Funciona en Bookworm, Trixie y Sid
- ✅ Mantenimiento sencillo: Comandos apt simples para actualizar
📦 Repositorio de construcción de paquetes
Los paquetes de Debian se construyen y mantienen automáticamente en este repositorio de GitHub:
- 📁 forgejo-runner-debian - Latest release builds
🔗 Paquetes relacionados
También disponible desde deb.griffo.io:
- Forgejo - Forja de software ligera y autoalojada
- Garage - Almacenamiento de objetos distribuido compatible con S3
- Headscale - Servidor de control Tailscale autoalojado
💝 Apoyar este proyecto
¡Si este repositorio te ahorra tiempo y esfuerzo, considera apoyarlo!