Was ist Forgejo Runner?
Forgejo Runner ist der CI-Runner für Forgejo Actions. Es handelt sich um einen schlanken Daemon, der sich mit Ihrer Forgejo-Instanz verbindet, wartende Workflow-Jobs entgegennimmt und diese auf Ihrer eigenen Infrastruktur ausführt — über Docker, LXC oder direkt auf dem Host —, sodass Sie eine vollständig selbst gehostete, zu GitHub Actions kompatible CI/CD-Pipeline erhalten.
⚡ Wichtigste Funktionen von Forgejo Runner
🔁 Actions-kompatibel
Führt Workflows mit derselben Syntax und demselben Actions-Ökosystem wie GitHub Actions aus.
🐳 Flexible Ausführung
Jobs in Docker-Containern, LXC oder direkt auf der Host-Maschine ausführen.
🔐 Selbst gehostet
Behalten Sie Ihre CI/CD vollständig auf Ihrer eigenen Infrastruktur — ganz ohne Abhängigkeit von Drittanbietern.
⚖️ Skalierbar
Registrieren Sie mehrere Runner mit Labels, um Workloads zu verteilen und gezielt anzusprechen.
🎯 Warum Forgejo Runner?
- Eigene CI: Pipelines auf Hardware ausführen, die Sie selbst kontrollieren
- Actions-Ökosystem: Bestehende Workflow-Definitionen im GitHub-Stil weiterverwenden
- Flexible Isolation: Docker-, LXC- oder Host-Ausführung je nach Bedarf
- Leichtgewichtig: Eine einzige Go-Binärdatei, die sich einfach bereitstellen lässt
🆕 Highlights
- Job-Ausführung: Führt wartende Forgejo-Actions-Workflows aus
- Labels: Jobs gezielt an bestimmte Runner weiterleiten
- Container-Unterstützung: Isolierte Builds via Docker
- Daemon-Modus: Läuft dauerhaft als Dienst
📦 Installation von deb.griffo.io
Schritt 1: Repository hinzufügen
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🆓 Es gibt einen für immer kostenlosen Spiegel. deb-free.griffo.io liefert Pakete für immer kostenlos — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Derzeit enthält er cliamp, Ghostty, lazydocker, Oh My Posh und Zed; Forgejo Runner ist nicht dabei, deshalb führt heute nur das Repository oben dorthin — auf Anfrage kann es aufgenommen werden.
🧩 Zur extrepo-Option. extrepo ist Debians eigenes Werkzeug für externe Repositories: Es legt die Sources-Datei an und installiert den Signaturschlüssel für dich, nachdem es ihn gegen signierte Metadaten geprüft hat. Dieses Repository ist dort als griffo registriert, der für immer kostenlose Spiegel als griffo-free. Unter Debian (bookworm, trixie, forky und sid) sind die Befehle oben damit die gesamte Einrichtung.
extrepo richtet nur die Sources-Datei und den Schlüssel ein; die Zugangsdaten eines Abos gehören weiterhin in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu wird nicht abgedeckt, denn extrepo veröffentlicht Metadaten nur für Debian-Suites: dort nimmst du die Befehle mit sudo oder als root.
Schritt 2: forgejo-runner installieren
# 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🎯 Grundlegende Verwendungsbeispiele
# 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🚀 Warum deb.griffo.io wählen?
- Offizielles Debian: Oft monatelang veraltet, ohne die neuesten Funktionen
- deb.griffo.io: Neueste Version innerhalb von Stunden nach dem Release
- Manuelle Installation: Manuelles Herunterladen und PATH-Einrichtung erforderlich
- Unser Repository: Vorgefertigte, einsatzbereite Pakete
- ✅ Neueste Funktionen: Erhalten Sie die neuesten Forgejo-Runner-Funktionen und -Verbesserungen sofort
- ✅ Keine manuelle Einrichtung: Vorgefertigte Binärdateien, installiert und aktualisiert über apt
- ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach den Upstream-Releases aktualisiert
- ✅ Korrekte Abhängigkeiten: Korrekt paketiert mit allen erforderlichen Bibliotheken
- ✅ Multi-Distribution: Funktioniert auf Bookworm, Trixie und Sid
- ✅ Einfache Wartung: Einfache apt-Befehle für Updates
📦 Paket-Build-Repository
Die Debian-Pakete werden automatisch in diesem GitHub-Repository erstellt und gepflegt:
- 📁 forgejo-runner-debian - Neueste Release-Builds
🔗 Verwandte Pakete
Auch verfügbar von deb.griffo.io:
- Forgejo - Selbst gehostete, leichtgewichtige Software-Forge
- Garage - S3-kompatibler verteilter Objektspeicher
- Headscale - Selbst gehosteter Tailscale-Kontrollserver
💝 Dieses Projekt unterstützen
Wenn Ihnen dieses Repository Zeit und Mühe erspart, unterstützen Sie es doch bitte!