Forgejo, Gitea oder cgit: Welcher Git-Server?
Vergleichen Sie vier selbst gehostete Git-Server nach RAM: Bare-Repositories per SSH, cgit, Forgejo oder Gitea und GitLab. Was passt auf einen VPS mit 1 GB?
Welchen selbst gehosteten Git-Server sollten Sie betreiben
Ein selbst gehosteter Git-Server ist kein einzelnes Produkt. Der Arbeitsspeicher (RAM) Ihres VPS entscheidet, welche Variante Sie betreiben können. Git benötigt keinen eigenen Daemon: Ein Bare-Repository zusammen mit einem SSH- (Secure Shell-)Account ist bereits ein funktionsfähiger Server auf dem kleinsten Server, den Sie mieten können. Alles darüber hinaus ist eine Webanwendung, die Sie zusätzlich betreiben. Jeder weitere Schritt benötigt mehr Arbeitsspeicher, den ein kleiner VPS möglicherweise nicht bereitstellt. Wenn Sie noch unsicher sind, wo Git endet und GitHub beginnt, erläutert wie sich Git, GitHub und ein eigener Git-Server unterscheiden diese Abgrenzung, bevor Sie eine Größenklasse auswählen.
Es gibt vier Stufen. Ein Bare-Repository über SSH, ohne dass ein zusätzlicher Dienst auf einem Port lauscht. cgit, eine schnelle schreibgeschützte Webansicht ohne Datenbank. Forgejo oder Gitea, eine vollständige Forge mit Accounts, Issues und Pull Requests in wenigen hundert Megabytes. GitLab, das einen Server erwartet, der ein Vielfaches der Größe der anderen Systeme hat.
Legen Sie die Auswahl anhand der benötigten Funktionen fest. Vergleichen Sie anschließend den erforderlichen Arbeitsspeicher mit dem gebuchten Tarif.
Wie viel RAM die einzelnen Optionen tatsächlich benötigen
Nur zwei dieser Projekte veröffentlichen konkrete Hardwareangaben. Betrachten Sie eine veröffentlichte Angabe als Mindestwert, nicht als Garantie, und messen Sie Ihre eigene Instanz nach dem Start mit systemd-cgtop oder ps -o rss= -C forgejo.
Die Daten hinter diesem Diagramm
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Gitea dokumentiert 1 GB RAM mit 2 CPU-Kernen als normalerweise ausreichend für kleine Teams und Projekte und nennt einen Raspberry Pi 3 als ausreichend für kleine Arbeitslasten. GitLab dokumentiert 16 GB als Grundlage für eine Installation auf einem einzelnen Node und 8 GB als Untergrenze für eine Umgebung mit knappem Arbeitsspeicher, wie sie auf der eigenen Seite bezeichnet wird. Die Installationsdokumentation von Forgejo enthält keine RAM-Angabe. Forgejo ist ein Fork von Gitea und verhält sich entsprechend. Daher ist die Gitea-Angabe die nächstliegende veröffentlichte Orientierung.
Was das auf einem 1 GB VPS bedeutet: Bare-Repositories und cgit passen mit verbleibendem Speicher darauf, weil keiner der beiden Dienste dauerhaft als Dienstprozess läuft. Forgejo oder Gitea starten und können ein kleines Team mit SQLite versorgen. Sie befinden sich damit jedoch auf der dokumentierten Untergrenze. Lassen Sie PostgreSQL und den CI-Runner (Continuous Integration) deshalb auf diesem Rechner deaktiviert. Wenn die Weboberfläche ohne Fehlermeldung verschwindet, führen Sie sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' aus und suchen Sie nach einer Zeile wie Out of memory: Killed process 1181 (forgejo). Das bedeutet, dass der Out-of-Memory-Killer des Kernels den Prozess beendet hat. GitLab auf einem Rechner mit 1 GB ist kein Optimierungsproblem. Es wird nicht funktionieren.
Tier 0: ein Bare-Repository über SSH
Git hat keinen Netzwerk-Daemon, den Sie starten müssen. git push über SSH führt git-receive-pack auf der anderen Seite als normalen Unix-Prozess aus. Daher ist jedes Konto, das Sie mit einem Schlüssel erreichen können, bereits ein Git-Remote. Richten Sie ein Konto für die Repositories ein. Bewahren Sie die Repositories außerhalb seines Home-Verzeichnisses auf. Dadurch benötigt eine später hinzugefügte Webansicht keinen Zugriff auf dieses Home-Verzeichnis.
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
--group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git--bare erstellt ein Repository ohne Working Copy. Das ist der Repository-Typ, den ein Server verwaltet. Das Pushen auf den ausgecheckten Branch eines Repositorys mit Working Copy wird standardmäßig mit refusing to update checked out branch: refs/heads/main abgelehnt. Das ist der häufigste Fehler auf dieser Stufe.
Geben Sie dem Konto nun einen Schlüssel und klonen Sie das Repository.
sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keysgit remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin mainEin erfolgreicher erster Push endet mit * [new branch] main -> main. Wenn der Vorgang mit git@vps.example.com: Permission denied (publickey) endet, ist die Authentifizierung nicht erfolgreich gewesen. Lesen Sie dann das Server-Log mit sudo journalctl -u ssh -n 20. Eine Zeile mit Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys bedeutet, dass der Eigentümer oder der Dateimodus falsch ist. sshd lehnt eine Schlüsseldatei mit einem nicht vertrauenswürdigen Eigentümer oder mit Berechtigungen ab, die anderen Benutzern das Schreiben ermöglichen.
Wenn das origin-Repository des Projekts bereits auf GitHub verweist, endet git remote add origin mit error: remote origin already exists.. Wenn Sie diesen Server als zweite Push-URL für dieses Remote hinzufügen, kann ein git push beide aktualisieren.
Entziehen Sie dem Konto anschließend die Shell.
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell akzeptiert nur die wenigen Befehle, die Git über SSH sendet. Eine interaktive Anmeldung endet daher jetzt mit einer Meldung statt mit einer Eingabeaufforderung:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.Das ist der gesamte Server. Es gibt keine Datenbank und keinen Webprozess, den Sie aktualisieren müssen. Sie verzichten auf alle Funktionen einer Forge: kein Browsing, kein Issue-Tracker, keine Pull Requests und keine benutzerbezogenen Berechtigungen. Jeder Schlüssel in dieser Datei kann jedes Repository lesen und ändern, das der Benutzer git besitzt.
Tier 1: cgit bietet eine Webansicht ohne Datenbank
cgit ist ein in C geschriebenes CGI-Programm (Common Gateway Interface). Der Webserver führt es einmal pro Anfrage aus. cgit liest die Repositories direkt von der Festplatte und speichert keinen eigenen Zustand. Ubuntu 24.04 enthält es in der Komponente universe.
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitVerweisen Sie in /etc/cgitrc auf das Repository-Verzeichnis:
root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/gitscan-path durchsucht dieses Verzeichnis und listet jedes gefundene Repository auf. Dadurch erscheint ein neues Bare-Repository ohne zusätzliche Konfiguration. cache-size gibt die Anzahl der zwischengespeicherten Seiten an. Bei dem Wert null bleibt das Caching deaktiviert. Lesen Sie den Inhalt, den Ihr Paket bereits in /etc/cgitrc eingetragen hat, bevor Sie Zeilen hinzufügen. Das Debian- und Ubuntu-Paket liefert eigene Standardwerte mit.
Jeder Eintrag zeigt die erste Zeile der Datei description des Repositorys. Ein neues Bare-Repository wird daher als Unnamed repository; edit this file 'description' to name the repository. aufgeführt. Beheben Sie das einmal pro Repository:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionDie nginx-Sitedatei und ihre Prüfung
server {
listen 80;
server_name git.example.com;
root /usr/share/cgit;
try_files $uri @cgit;
location @cgit {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
fastcgi_param PATH_INFO $uri;
fastcgi_param QUERY_STRING $args;
fastcgi_param HTTP_HOST $server_name;
fastcgi_pass unix:/run/fcgiwrap.socket;
}
}sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listenroot /usr/share/cgit stellt cgit.css und cgit.png als reguläre Dateien bereit. try_files übergibt alles andere an das CGI unter /usr/lib/cgit/cgit.cgi. Eine 502-Seite mit connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) in /var/log/nginx/error.log bedeutet, dass die Socket-Unit nicht läuft oder an einem anderen Pfad lauscht. Die Zeile systemctl show gibt den tatsächlich verwendeten Pfad aus.
Bevor Sie darauf aufbauen, sollten Sie zwei Einschränkungen kennen. cgit ist in dieser Konfiguration schreibgeschützt und verfügt über keine Anmeldung. Daher ist alles unter scan-path öffentlich. Legen Sie private Repositories nicht in diesem Verzeichnis ab, oder schalten Sie eine HTTP-Basisauthentifizierung vor die gesamte Site. Das CGI läuft außerdem unter dem Benutzer des Webservers. Dieser Benutzer muss /srv/git durchlaufen und jedes Repository lesen können. Wenn er ein Verzeichnis nicht betreten kann, wird ein leerer Index statt eines Fehlers angezeigt.
Tier 2: Forgejo oder Gitea für Issues und Pull Requests
Forgejo und Gitea verfolgen dasselbe Konzept: eine Go-Binärdatei, die eine Webforge mit Benutzern, Organisationen, Issues, Pull Requests, Releases, einer Paketregistrierung und einem integrierten CI-System bereitstellt. Für die vollständige Installation benötigen Sie nur die Binärdatei und SQLite. Deshalb eignen sie sich für Hardware, auf der GitLab nicht betrieben werden kann. Die folgende Compose-Datei stammt aus der Forgejo-Dokumentation und verwendet den dort am 24 October 2026 genannten Image-Tag.
networks:
forgejo:
external: false
services:
server:
image: codeberg.org/forgejo/forgejo:17
container_name: forgejo
environment:
- USER_UID=1000
- USER_GID=1000
restart: always
networks:
- forgejo
volumes:
- ./forgejo:/data
- /etc/localtime:/etc/localtime:ro
ports:
- '3000:3000'
- '222:22'Dieser 17-Tag folgt dem v17-Zweig. Forgejo v17.0.1 wurde am 26 October 2026 veröffentlicht und ist die aktuelle stabile Version. Forgejo unterstützt v17 bis zum 28 January 2027. Der ältere v16-Zweig verlor am 29 October 2026 den Support. Eine bestehende Installation mit dem 16-Tag muss daher jetzt aktualisiert werden. Der Wechsel von einer Hauptversion zur nächsten ist später ein manuelles Upgrade. Deshalb ist es günstiger, direkt mit der aktuellen Version zu beginnen.
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1Die curl-Zeile sollte eine HTTP-Statuszeile ausgeben. Vor Abschluss der Ersteinrichtung kann es sich um eine Weiterleitung zu /install handeln. Das bedeutet trotzdem, dass der Dienst läuft. Wenn der Container stattdessen beendet wird, ist die häufigste Ursache ein falscher Besitz: Das Verzeichnis ./forgejo muss dem in USER_UID angegebenen UID (user id) gehören. Andernfalls kann der Prozess nicht in sein eigenes Datenverzeichnis schreiben. Docker Compose auf einem VPS beschreibt diese Dateistruktur und die Regel für den Besitz der Volumes vollständig.
Zwei Antworten auf der Einrichtungsseite entscheiden darüber, ob Clone-URLs funktionieren. Der SSH-Port muss dem Host-Teil der SSH-Zuordnung entsprechen. In der obigen Compose-Datei ist das 222, weil damit der Host-Port 222 auf den Container-Port 22 abgebildet wird. Der Port 222 ist nicht vorgeschrieben. Jeder freie Host-Port funktioniert, sofern die Zuordnung und diese Antwort übereinstimmen. Außerdem muss die Domain dem Namen entsprechen, den Benutzer tatsächlich eingeben. Ist eine der beiden Angaben falsch, zeigt jede Repository-Seite einen Clone-Befehl an, der für alle Benutzer fehlschlägt, die ihn kopieren. Beide Angaben befinden sich anschließend im Abschnitt [server] von app.ini, und zwar als SSH_PORT, SSH_DOMAIN und ROOT_URL.
Veröffentlichen Sie bei einer öffentlich erreichbaren Instanz den Web-Port nur auf der Loopback-Adresse ('127.0.0.1:3000:3000') und schalten Sie nginx für TLS (transport layer security) davor. Gitea lässt sich genauso aus dem von seiner Dokumentation verwendeten docker.gitea.com/gitea-Image installieren oder als einzelne Binärdatei mit einer systemd-Unit und einem app.ini. Die aktuelle stabile Version ist v28.4.0 und wurde am 15 November 2026 veröffentlicht. Mit v28.0.0 entfernte das Projekt Ende September das alte 1.-Präfix. Nach 1.27 folgt daher 28, nicht 1.28.
Bleiben Sie so lange wie möglich bei SQLite. Dadurch besteht die Instanz aus nur einem Prozess und einer Datei. Nach einem Reboot ist kein zusätzlicher Dienst zu überwachen. PostgreSQL lohnt sich, wenn mehrere Personen gleichzeitig schreiben, weil SQLite Schreibvorgänge serialisiert und lange CI-Läufe ständig Schreibzugriffe erzeugen. Beide Projekte können eine bestehende Instanz später nach PostgreSQL migrieren. Diese Entscheidung ist daher nicht endgültig.
Forgejo oder Gitea: Die tatsächlichen Unterschiede
Die Abstammung ist gemeinsam. Gitea wurde 2016 von Gogs geforkt. Ende 2022 gingen die Kontrolle über die Gitea-Domain und die Marke an ein Unternehmen, Gitea Ltd, über. Mehrere Maintainer gründeten daraufhin gemeinsam mit Codeberg Forgejo. Forgejo wird von seiner Community unter dem Dach von Codeberg e.V. entwickelt. Dabei handelt es sich um einen in Deutschland eingetragenen gemeinnützigen Verein, der die Domains des Projekts hält. Die Governance bleibt bei den eigenen Mitwirkenden von Forgejo. 2024 wechselte das Projekt von der MIT-Lizenz zu GPLv3 (GNU general public license version 3). Gitea bleibt unter der MIT-Lizenz und wird mit kommerzieller Unterstützung entwickelt.
Im täglichen Betrieb sind die Funktionsumfänge ähnlich. Der Migrationspfad zwischen beiden Projekten ist es nicht. Forgejo v10.0 von January 2025 war die letzte Version, die eine Gitea-Datenbank direkt übernehmen konnte, und auch das nur ab Gitea v1.22 oder älter. Gitea ist am 16 November 2026 bei v28.4.0. Für eine aktuelle Gitea-Instanz gibt es daher keinen unterstützten direkten Wechsel zu Forgejo. Entscheiden Sie sich für eines der beiden Projekte, bevor Sie Daten eintragen. Behandeln Sie einen späteren Wechsel als Export und anschließenden Re-Import.
Eine kurze Entscheidungshilfe: Wenn Ihnen die Governance wichtig ist oder Sie ein Projekt unter dem Dach eines gemeinnützigen Vereins betreiben möchten, verwenden Sie Forgejo. Wenn Sie eine größere Installationsbasis und eine kommerzielle Supportoption wünschen, verwenden Sie Gitea. Beide Projekte werden offen entwickelt und regelmäßig veröffentlicht. Forgejo veröffentlicht alle drei Monate eine stabile Version und jedes Jahr eine LTS-Version (long term support). Am 29 October 2026 waren v17.0.1 die aktuelle Version und v15.0.11 die LTS-Version. Forgejo unterstützt v17 bis zum 28 January 2027 und v15 bis zum 15 July 2027. Der Support für v16 endete am 29 October 2026. Prüfen Sie daher die Releases-Seite, bevor Sie eine Hauptversion festlegen. Wenn keine dieser Regeln die Entscheidung klärt, erläutert der vollständige Vergleich von Forgejo und Gitea, wie sich deren Actions und Paketregistrierungen unterscheiden. Diese Details sollten Sie klären, bevor ein Wechsel durch Ihre Daten aufwendig wird.
Stufe 3: Was GitLab kostet, bevor es überhaupt etwas tut
GitLab CE gehört zu einer anderen Softwareklasse. Eine Instanz besteht aus mehreren zusammenarbeitenden Diensten: Puma für die Webanwendung, Sidekiq für Hintergrundaufgaben, PostgreSQL, Redis, Gitaly für den Repository-Zugriff und nginx als vorgeschalteter Dienst. Das Omnibus-Paket installiert sie gemeinsam. Dadurch wird die Installation einfach, aber der Mindestbedarf an Arbeitsspeicher hoch.
Auf der GitLab-Anforderungsseite werden 16 GB RAM und 8 vCPU als Ausgangspunkt für eine Installation auf einem einzelnen Node dokumentiert. Für Umgebungen mit begrenztem Arbeitsspeicher werden dort 8 GB als Untergrenze genannt. Auf derselben Seite wird empfohlen, Swap zu deaktivieren, weil Swapping unter Last die Instanz stark beeinträchtigt. Das sind die veröffentlichten Werte vom October 2026. Sie sind im Laufe der Jahre gestiegen. Lesen Sie die Seite daher erneut, bevor Sie einen Server dimensionieren.
Für diesen Ressourcenbedarf erhalten Sie konkrete Funktionen: eine Container Registry, eine Package Registry, fein abgestufte Berechtigungen und CI, das in großem Maßstab getestet wurde. Das Compliance Center sowie Audit-Trails für Projekte oder Gruppen erfordern eine kostenpflichtige GitLab-Stufe. Wenn niemand in Ihrem Team eine Funktion aus dieser Liste nennen kann, die er in diesem Quartal benötigt, bezahlen Sie für einen größeren VPS, ohne dafür einen Nutzen zu erhalten.
Das SSH-Zugriffsmodell: ein Git-Benutzer und viele Schlüssel
Mit system OpenSSH authentifiziert sich jede Ebene auf dieselbe Weise. Es gibt ein Unix-Konto namens git, und jeder öffentliche Schlüssel wird in der ~/.ssh/authorized_keys dieses Kontos abgelegt. Der Schlüssel dient zur Authentifizierung. Die Autorisierung wird durch die Optionen festgelegt, die Sie in derselben Zeile vor den Schlüssel schreiben.
Eine einfache Schlüsselzeile gewährt dem Inhaber alle Berechtigungen, die dieses Konto besitzt. Für ein Konto, das weiterhin /bin/bash als Login-Shell verwendet, schränkt ein erzwungener Befehl den Zugriff auf Git ein:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict, verfügbar seit OpenSSH 7.2, deaktiviert Portweiterleitung, Agent-Weiterleitung, X11 und die Zuweisung eines PTY (Pseudo-Terminals) mit einem einzigen Schlüsselwort. command= ersetzt die vom Client angeforderte Aktion durch die von Ihnen angegebene. Git funktioniert weiterhin, weil der SSH-Server den ursprünglichen Befehl des Clients in $SSH_ORIGINAL_COMMAND ablegt.
Eine Forge erstellt diese Datei für Sie. Das ist der wesentliche Unterschied zwischen Ebene 0 und Ebene 2. Wenn Forgejo und Gitea hinter dem system OpenSSH-Server betrieben werden, der ihre Standardeinstellung ist, schreiben sie authorized_keys mit einer Zeile pro registriertem Schlüssel neu. Jede Zeile enthält einen erzwungenen Befehl, der den Schlüssel anhand seiner Datenbank-ID identifiziert:
command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere aliceDieser erzwungene Befehl macht aus einem gemeinsamen Unix-Konto benutzerbezogene Berechtigungen: key-3 teilt der Forge mit, welcher Benutzer eine Verbindung herstellt, und sie prüft diesen Benutzer gegen das Repository, bevor Objekte übertragen werden. Bearbeiten Sie diese Datei auf einem von einer Forge verwalteten System nicht manuell. Sie wird aus der Datenbank neu erstellt, und Ihre Zeile verschwindet. Wenn Sie den integrierten SSH-Server der Forge aktivieren oder OpenSSH über AuthorizedKeysCommand nach Schlüsseln bei der Forge fragen lassen, benötigt die Forge diese Datei überhaupt nicht. In letzterem Fall weisen beide Projekte Sie an, ihre Erstellung zu deaktivieren. Deploy Keys verwenden denselben Mechanismus: Ein Deploy Key ist ein gewöhnlicher SSH-Schlüssel, der für ein einzelnes Repository registriert ist. Er ist normalerweise schreibgeschützt. Die Prüfung erfolgt in der Forge und nicht in sshd.
Zwei Gewohnheiten sind wichtiger als alle oben genannten Konfigurationen. Verwenden Sie einen Schlüssel pro Person oder pro Maschine und niemals einen gemeinsamen Schlüssel. Wenn Sie einen gemeinsamen Schlüssel widerrufen, müssen Sie ihn für alle gleichzeitig austauschen. Entfernen Sie Schlüssel außerdem an dem Tag, an dem jemand das Unternehmen verlässt. Ein alter Schlüssel in dieser Datei ermöglicht dauerhaft einen Login, den niemand überwacht. Gutes SSH-Schlüsselmanagement auf einem Server behandelt Schlüsseltypen und Passphrasen. Alle dort genannten Grundsätze gelten hier unverändert. Wenn das System neu ist, sollten Sie die ersten zehn Minuten auf einem neuen VPS durchführen, bevor Sie Repositories darauf ablegen.
Kann ich GitHub Actions auf meinem eigenen Git-Server ausführen?
Sie können Workflows ausführen, die in der Syntax von GitHub Actions geschrieben sind. GitHub selbst können Sie nicht ausführen. Forgejo Actions ist seit Forgejo v1.21 standardmäßig aktiviert und liest Workflow-Dateien aus .forgejo/workflows in jedem Repository. Gitea Actions funktioniert auf dieselbe Weise und liest .gitea/workflows. Beide benötigen ein zweites Programm, den Runner, das installiert und für Ihre Instanz registriert wird. Dafür wird ein Token aus den Administratoreinstellungen benötigt. Viele veröffentlichte Actions laufen unverändert.
Planen Sie zwei Folgen ein. Mit den üblichen Container-Labels startet der Runner für jeden Job einen Container. Deshalb benötigt er eine eigene Container-Engine und ein eigenes Speicherbudget. Daher gehört er nicht auf denselben Rechner mit 1 GB wie die Forge. Beide Runner können Jobs auch direkt auf dem Host ausführen. Bei Forgejo erfolgt dies über ein Label, das mit :host endet. Dafür ist keine Engine erforderlich, aber zwischen dem Job und diesem Rechner befindet sich dann auch kein Container. Außerdem führt der Runner alles aus, was eine Workflow-Datei vorgibt. In der Dokumentation von Forgejo steht das ausdrücklich: Der Runner führt Remote-Code aus. Geben Sie ihm nach Möglichkeit einen eigenen Host oder mindestens einen eigenen unprivilegierten Benutzer und ein Registrierungstoken, das auf ein Repository beschränkt ist.
Wenn Ihre Repositories bei GitHub bleiben und Sie nur die Ausführung auf Hardware verlagern möchten, die Sie kontrollieren, handelt es sich um eine andere Konfiguration mit anderen Schritten: ein selbst gehosteter GitHub-Actions-Runner wird an ein GitHub-Repository angebunden und benötigt nichts davon. Wenn Sie noch abwägen, was Sie der Weggang kostet, trennt was GitHub tatsächlich bietet das Git-Hosting von dem Netzwerk, das es umgibt.
Backups: Repositories sind nur die halbe Zustandsinformation
Ein Bare Repository ist ein Verzeichnis. Beim Kopieren werden daher alle darin enthaltenen Daten kopiert. Ein Mirror-Clone von einem anderen Rechner ist ein echtes Backup und wird direkt am bestehenden Ziel aktualisiert:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateDabei werden alle Refs und alle Objekte abgerufen. Serverseitige Hooks und die Datei description werden nicht abgerufen. Wenn Sie Hooks verwenden, erstellen Sie daher zusätzlich eine Kopie des Verzeichnisses auf Dateiebene.
Eine Forge speichert Issues, Pull Requests, Benutzer, Schlüssel und Berechtigungen in ihrer Datenbank. Eine Kopie der Repositories allein lässt all diese Daten weg. Beide Projekte stellen einen Dump-Befehl bereit, der die Datenbank, die Repositories, die Konfiguration und die Anhänge in ein gemeinsames Archiv schreibt:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipUnter Docker wird derselbe Befehl innerhalb des Containers ausgeführt. Der Pfad zur Konfiguration hängt vom Image ab. Prüfen Sie ihn daher, bevor Sie den Befehl eingeben:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniFühren Sie den Befehl als Benutzer aus, dem die Daten gehören, und schreiben Sie das Archiv in ein Verzeichnis, in das dieser Benutzer schreiben darf. Kopieren Sie das Archiv anschließend vom Server herunter. Ein Backup, das nur auf dem gesicherten Rechner vorhanden ist, ist kein Backup. Das Wiederherstellen wird häufig übersprungen. Entpacken Sie jetzt einen Dump auf einem Ersatzsystem. So lernen Sie den Ablauf in Ruhe kennen und nicht erst während eines Ausfalls.
Nach Szenario auswählen
Eine Person mit einem Laptop und einem VPS, ohne Bedarf an einer Weboberfläche: Bare-Repositories über SSH. Es läuft kein zusätzlicher Dienst, und es gibt nichts zu aktualisieren.
Dasselbe Szenario, aber Sie möchten Code im Browser lesen und Links dazu teilen: cgit hinzufügen. Weiterhin keine Datenbank und kein dauerhaft laufender Dienst.
Ein Team, das den Code der anderen prüft und Issues verwaltet: Forgejo oder Gitea auf einem Server mit mindestens 2 GB RAM. Verschieben Sie den CI-Runner auf einen zweiten Rechner, sobald die Jobs umfangreicher werden.
Eine Organisation, die eine Container-Registry und Audit-Trails benötigt und dem Server 16 GB RAM zur Verfügung stellt: GitLab. Wenn dieses Budget nicht vorhanden ist, sollten Sie GitLab nicht einsetzen.
Der Wechsel in eine der ersten drei Stufen ist kostengünstig, weil die Repositories in allen drei Fällen gewöhnliche Git-Verzeichnisse auf dem Datenträger sind. Beginnen Sie mit der niedrigsten Stufe, die Ihre Anforderungen erfüllt. Wenn Sie prüfen, welche weiteren Dienste auf demselben Server Platz bekommen sollten, stellt die Auswahlliste für lohnenswerte Self-Hosting-Dienste einen Git-Server neben die anderen Diensten, die um diesen Arbeitsspeicher konkurrieren.
FAQ
Kann ein 1-GB-VPS Forgejo oder Gitea ausführen?
Ja, für ein kleines Team, mit SQLite und ohne weitere rechenintensive Dienste auf dem Server. Die Dokumentation von Gitea nennt 1 GB RAM und 2 CPU-Kerne als typischerweise ausreichend für kleine Teams und Projekte. Forgejo ist ein Fork von Gitea und hat ähnliche Anforderungen. Installieren Sie auf diesem Rechner weder PostgreSQL noch einen CI-Runner. Wenn der Dienst ohne Fehlermeldung in seinem eigenen Log verschwindet, führen Sie sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' aus: Eine Zeile mit dem Namen des beendeten Prozesses bedeutet, dass der Out-of-Memory-Killer des Kernels den Prozess beendet hat. Die Lösung ist dann ein größerer Tarif und kein Tuning-Flag.
Was ist der Unterschied zwischen Forgejo und Gitea?
Beide haben eine gemeinsame Codebasis-Geschichte und bieten größtenteils dieselben Funktionen. Gitea wurde 2016 von Gogs geforkt. Forgejo wurde Ende 2022 von Gitea geforkt, nachdem die Kontrolle über die Gitea-Marke an ein Unternehmen übergegangen war. Forgejo wird von seiner Community unter dem Dach von Codeberg e.V., einer gemeinnützigen Organisation in Deutschland, entwickelt und unter GPLv3 veröffentlicht. Gitea bleibt unter der MIT-Lizenz und wird kommerziell unterstützt. Der praktische Unterschied betrifft den Migrationspfad. Forgejo v10.0 vom Januar 2025 war die letzte Version, die eine Gitea-Datenbank direkt übernehmen konnte, und zwar nur von Gitea v1.22 oder älter. Eine aktuelle Gitea-Instanz kann daher nicht unterstützt direkt vor Ort umgestellt werden.
Kann ich GitHub-Actions-Workflows auf einem selbst gehosteten Git-Server ausführen?
Forgejo Actions und Gitea Actions führen beide Workflows aus, die in der YAML-Syntax von GitHub Actions geschrieben sind und aus .forgejo/workflows und .gitea/workflows gelesen werden. Sie installieren ein separates Runner-Programm und registrieren es bei Ihrer Instanz. Viele veröffentlichte Actions funktionieren unverändert. Der Runner führt beliebigen Code aus Ihren Repositorys aus und startet mit den üblichen Container-Labels pro Job einen Container. Geben Sie ihm daher einen eigenen Host oder zumindest einen eigenen Benutzer ohne privilegierte Rechte. Betreiben Sie ihn nicht auf einem 1-GB-Server, auf dem bereits die Forge läuft.
Wie sichere ich einen selbst gehosteten Git-Server?
Bei Bare-Repositorys kopiert git clone --mirror von einem anderen Rechner alle Refs und Objekte. git remote update innerhalb dieses Mirrors aktualisiert ihn. Bei Forgejo oder Gitea sind die Repositorys nur ein Teil des Zustands, da Issues, Pull Requests, Benutzer und Schlüssel in der Datenbank gespeichert werden. Verwenden Sie den integrierten Dump sudo -u git forgejo dump -c /etc/forgejo/app.ini oder bei einer Docker-Installation denselben Befehl innerhalb des Containers. Kopieren Sie das Archiv vom Server herunter und stellen Sie es einmal auf einem Ersatzrechner wieder her, damit Sie wissen, dass das Verfahren funktioniert.