{"canonical_url":"https://engineer.company/de/glossary/forge/","content_markdown":"# Forge\n\n## Was es ist\n\nEine Forge, auch Software-Forge, Code-Forge oder Git-Forge genannt, ist der\nServer, den ein Team als Heimat seiner Repositories festlegt, samt den Diensten,\ndie es darum herum betreibt. Jeder vollständige Klon eines Git-Repositorys enthält\ndie gesamte Historie. Grundsätzlich ist daher keine Kopie einer anderen\nübergeordnet. Praktisch braucht ein Team einen Ort für Pushes, einen Ort,\nder über Lese- und Schreibrechte entscheidet, und einen Ort für die Gespräche\nüber den Code. Dieser Ort ist die Forge.\n\nIm Kern speichert eine Forge Bare-Repositories, die reine Historie ohne\nausgecheckte Dateien, und spricht eines oder mehrere der Übertragungsprotokolle\nvon Git.\nDas Git-Buch nennt vier: das lokale Protokoll für ein Verzeichnis auf demselben\nRechner, HTTP, SSH und das eigene Git-Protokoll mit einem Daemon auf Port 9418,\nganz ohne Authentifizierung. Alles Weitere baut darauf auf, in sehr\nunterschiedlichem Umfang.\n\nForgejos Dokumentation beschreibt das umfangreiche Ende des Spektrums:\nIssue-Verwaltung, Pull Requests, ein integriertes Wiki, eine Paketregistry für\nviele Sprachökosysteme, Forgejo Actions zum Ausführen von Jobs,\nRepository-Spiegel, Migration aus anderen Diensten, Branch- und Tag-Schutz sowie\nWebhooks. Soft Serve steht am anderen Ende. Es beschreibt sich als\n„selbst hostbarer Git-Server für die Kommandozeile“: eine einzelne Binärdatei\nnamens `soft`, die Repositories über SSH, HTTP oder das Git-Protokoll ausliefert,\nden Zugriff mit öffentlichen SSH-Schlüsseln steuert und Mitwirkende, private\nRepositories und Webhooks unterstützt. Beides sind Forges. Sie unterscheiden\nsich darin, wie viel Teamarbeit sie aufnehmen wollen.\n\nForges beginnen auch, miteinander zu sprechen. ForgeFed ist ein auf ActivityPub\naufbauendes Föderationsprotokoll für Plattformen zum Hosten und gemeinsamen\nBearbeiten von Softwareprojekten. Es modelliert Repositories, Ticket- und\nPatch-Tracker, Projekte und Teams als Akteure, die einander Aktivitäten senden.\nZiel ist eine gemeinsame Sprache für Netzwerke aus Forges und\nProjektmanagementwerkzeugen. Eine Person auf einem Server soll so ein Ticket\nfür ein Repository auf einem anderen eröffnen können. Ein Repository soll\nzwischen Servern umziehen können, während die alte Kopie schreibgeschützt\narchiviert bleibt und auf die neue Heimat verweist.\n\n## Warum es wichtig ist\n\nAuf der Forge werden Regeln durchsetzbar. Eine Regel auf einem\nEntwicklungsrechner gilt nur, solange dieser richtig eingerichtet ist.\nEin Hook auf dem Server läuft dagegen bei jedem Push. Gits Hook `pre-receive`\nliest jede übertragene Referenz als alte ID, neue ID und Namen von der\nStandardeingabe. Endet er mit einem Status ungleich null, wird keine der\nReferenzen aktualisiert. Branch-Schutz, verpflichtende Reviews und Prüfungen\nsignierter Commits auf größeren Forges verfeinern dieselbe Idee: Die gemeinsame\nKopie lehnt ab, was das Team vereinbart hat, nicht anzunehmen.\n\nDie Wahl einer Forge entscheidet auch, wer den Code hält. Ein gehosteter Dienst\nübernimmt Betriebskosten und Verfügbarkeit. Dafür liegen Code, Zugriffsliste\nund sämtliche Diskussionen auf fremder Hardware unter fremden Bedingungen.\nEigenbetrieb kehrt den Tausch um. Keine Wahl ist kostenlos. Der Unterschied\nzählt besonders für ein Unternehmen, das Kunden sagt, wo ihre Daten liegen.\n\nEine Forge hält außerdem Daten, die Git nicht enthält. Commits und Tags reisen\nmit jedem Klon. Issues, Review-Diskussionen, Zugriffslisten und serverseitige\nHooks gehören dagegen allein zur Forge. Diese Trennung bestimmt, was eine\nSicherung abdecken und ein Umzug zwischen Forges mitnehmen muss.\n\n## Wie es in der Praxis aussieht\n\nDieses Unternehmen betreibt eine eigene Forge. Drei Projekte auf dieser Website\nzeigen, was dafür nötig war.\n\nDer Quellcode des Unternehmens lag früher bei einem fremden Hostingdienst.\nDas Projekt zur\n[Bereitstellung einer eigenen Git-Forge](/de/portfolio/your-code-on-your-own-hardware/)\nbeginnt mit der Feststellung, dass eine Forge zu betreiben heißt, eine Forge\nzu betreiben: Authentifizierung, Zugriffskontrolle, Speicher, Sicherungen und\neine öffentliche Anlaufstelle dafür. Die Forge ist Soft Serve, eine einzelne\nvom Betriebssystem überwachte Binärdatei. Ausschlaggebend waren der Vorrang\nvon SSH und der Verzicht auf eine administrative Weboberfläche. Standardmäßig\nist sie privat: Anonymer Zugriff wird abgelehnt, ebenso Zugriff ohne Schlüssel,\nund jedes deklarierte Repository ist als privat markiert. Ihr SSH-Listener\nbindet nur an die Loopback-Schnittstelle auf Port 23231 und ist von außen über\neinen Sprungserver erreichbar. Ein Multiplexer, der HTTPS und Git über SSH auf\neinem öffentlichen Port zusammenführen würde, ist geschrieben, bleibt aber\nausgeschaltet. Ein ungenutzter Listener ist Angriffsfläche. Das Ergebnis wird\nklar benannt: Das Unternehmen hostet seinen Code auf eigener Hardware.\n\nAuch das Repository dieser Website liegt dort. Seine Anweisungen nennen die\nselbst gehostete Forge, Soft Serve über SSH, als kanonischen Remote. Sie\nbezeichnen die ältere gehostete Kopie als Legacy-Spiegel und halten fest,\ndass es keine gehostete CI gibt: Die verbindliche Qualitätsprüfung läuft lokal\nund in Git-Hooks.\n\nEin serverseitiger Hook muss in der Empfangsumgebung eines echten Git-Pushs getestet werden. Daher wurde er\n[an einem echten Bare-Repository und einem echten Push erprobt](/de/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/),\nbevor man ihm vertraute. Der Probelauf erzeugt ein Bare-Repository, installiert\nden Hook, klont, committet, pusht und prüft sowohl Annahme als auch Ablehnung.\nEr fand zwei Defekte, die beide in der Datei nicht sichtbar waren. Der zweite\nist besonders lehrreich: Git exportiert beim Ausführen eines Hooks eine\nVariable mit dem Repository-Verzeichnis. Die vom Hook gestartete Testsuite\nerbte sie. Neunzehn Tests wurden bei korrektem Code rot, bis die Umgebung an\nder Grenze bereinigt wurde. Die Seite nennt auch die Grenze des Probelaufs:\nEr erzeugt keine erzwungenen Aktualisierungen und keine Branch-Löschungen,\ndie ebenfalls Pushes sind.\n\nAll das teilt sich\n[einen Einkern-Host mit 512 MB Arbeitsspeicher](/de/portfolio/a-whole-company-on-one-small-server/)\nmit allen anderen öffentlich angebotenen Diensten des Unternehmens, von sieben\nTLS-Domains über den Onion-Dienst bis zu Gemini- und Gopher-Servern sowie\nAngreifersperren. Die Sicherungsautomatisierung ist separat implementiert;\ndas ist von aktiven Sicherungen zu unterscheiden. Eine Forge mit Webpanel\nwäre auf diesem Budget eine weitere dauerhaft laufende Anwendung gewesen.\nDeshalb wurden solche Plattformen bereits beim Entwurf ausgeschlossen. Der\nniedrigste Wert des verfügbaren Arbeitsspeichers lag auf diesem Host in einer\ndokumentierten eintägigen Messreihe bei etwa 310 MB von 464 MB.\n\n## Wo es schiefgeht\n\nAuf manchen Forges erhalten anonyme Besucher standardmäßig Lesezugriff.\nSoft Serves Dokumentation beschreibt die Voreinstellung als schreibgeschützten\nZugriff für anonyme Verbindungen, gesteuert durch `anon-access` und\n`allow-keyless`. Eine private Forge setzt Ersteres auf `no-access` und\nLetzteres auf false. Ein Test von einem Rechner ohne geladenen Schlüssel\nist sinnvoll. Gits eigener Daemon ist noch gröber: Laut Git-Buch\nist ein ausgeliefertes Repository entweder für alle klonbar oder wird überhaupt\nnicht ausgeliefert.\n\nEin Hook, der Git in einem anderen Verzeichnis aufruft, bearbeitet das falsche\nRepository. Bei einem Push führt Git die empfangenden Hooks im Bare-Repository\naus und exportiert `GIT_DIR` und verwandte Variablen, damit Git-Befehle im Hook\nes finden. Alles, was der Hook startet, erbt sie, auch ein Testlauf in einem\nCheckout an anderer Stelle. Das githooks-Handbuch weist darauf hin, diese\nVariablen vor der Arbeit in einem fremden Repository zu entfernen. Ein\nminimaler Hook `pre-receive`, der jeden übertragenen Commit in einem Wegwerfverzeichnis\nprüft, tut das in einer Subshell:\n\n```sh\nwhile read -r _ newrev _; do\n  git cat-file -e \"$newrev^{commit}\" 2\u003e/dev/null || continue\n  tree=$(mktemp -d)\n  git archive \"$newrev\" | tar -x -C \"$tree\"\n  (\n    unset $(git rev-parse --local-env-vars)\n    cd \"$tree\" \u0026\u0026 ./run-tests\n  ) || exit 1\ndone\n```\n\nEine wiederhergestellte Forge hat ihren Code zurück, aber ihre Regeln nicht.\nJeder Klon kann die Repositories eines verlorenen Servers neu befüllen. Das\nGit-Buch warnt jedoch, dass serverseitige Hooks und ähnliche Einstellungen\nzurückbleiben. Issues, Reviews, Schlüssel und Zugriffslisten waren nie in den\nKlonen. Eine Forge zu sichern heißt, ihr Datenverzeichnis und ihre Konfiguration\nzu sichern, beides irgendwo wiederherzustellen und zu prüfen, ob ein vom Hook\nabzulehnender Push tatsächlich abgelehnt wird.\n\nJeder von einer Forge geöffnete Listener muss verteidigt werden. Die\nBeispielkonfiguration von Soft Serve hat SSH auf Port 23231, HTTP auf 23232,\nden Git-Daemon auf 9418 und einen Statistikserver auf 23233. Ein Team, das nur\nüber SSH pusht, kann den Rest abschalten oder an Loopback binden. Offen bleibt dann nur,\nwas tatsächlich genutzt wird.\n\nEin Umzug zu einer anderen Forge nimmt den Code mit und lässt die Gespräche\nzurück. Ein Mirror-Push kopiert jede Referenz unter `refs/`, einschließlich\nBranches und Tags, und sonst nichts. Issues, Review-Diskussionen, Labels und\nZugriffslisten brauchen das Migrationswerkzeug der neuen Forge oder ein\nProtokoll wie ForgeFed. Dieses kopiert Commits, Tags, Tickets, Merge Requests\nund Kommentare und hinterlässt das alte Repository archiviert mit einem\nVerweis auf das neue.\n\n## Weiterführende Lektüre\n\n- [ForgeFed-Spezifikation](https://forgefed.org/spec/) — das Föderationsprotokoll\n  für Forges mit seinen Akteuren, Aktivitäten und dem Umzugsablauf, der ein altes\n  Repository archiviert.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — die eigene\n  Dokumentation des Projekts zu einem SSH-orientierten Git-Server aus einer\n  Binärdatei, einschließlich `anon-access` und `allow-keyless`.\n- [Forgejo-Dokumentation](https://forgejo.org/docs/latest/) — Anleitungen für\n  Administration und Nutzung einer voll ausgestatteten selbst gehosteten Forge,\n  von Installation und Sicherungen bis zu Actions und Spiegeln.\n- [githooks](https://git-scm.com/docs/githooks) — jeder von Git ausgeführte Hook,\n  einschließlich `pre-receive` und der von einem Push-Hook geerbten Umgebung.\n- [Die Protokolle](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols)\n  — die vier Wege der Datenübertragung zwischen Rechnern mit Git und ihr Aufwand\n  für Einrichtung und Sicherheit.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — die W3C-Empfehlung, die\n  ForgeFed erweitert.\n\n\u003chttps://engineer.company/de/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Was eine Forge zusätzlich zu Repositories bietet, wie klein sie sein kann und wo der Eigenbetrieb der gemeinsamen Codekopie Schwierigkeiten bereitet.","formats":{"gemtext":"https://engineer.company/de/glossary/forge/index.gmi","gopher":"https://engineer.company/de/glossary/forge/gophermap","html":"https://engineer.company/de/glossary/forge/","json":"https://engineer.company/de/glossary/forge/index.json","markdown":"https://engineer.company/de/glossary/forge/index.md","pdf":"https://engineer.company/de/glossary/forge/index.pdf"},"kind":"page","language":"de","title":"Was ist eine Forge?","url":"https://engineer.company/de/glossary/forge/","version":1}