Übersicht

git instaweb [--httpd=<daemon>] [--port=<n>] [--start | --stop | --restart]

Beschreibung

Der git instaweb-Befehl startet einen lokalen Webserver (lighttpd, Apache, webrick oder Pythons http.server), der die gitweb-Oberfläche für das aktuelle Repository hostet. Er öffnet einen Browser, der darauf zeigt, und gibt Ihnen eine schnelle Web-UI zum Durchstöbern von Historie, Dateien und Diffs ohne jegliches Setup.

Obwohl es ein Befehl im Kern-Git ist, ist gitweb selbst ältere Perl-basierte Software und nicht immer standardmäßig auf modernen Distros installiert. Viele Nutzer bevorzugen jetzt eine lokale Instanz von cgit, gitea oder einfach das Browsen auf einer gehosteten Forge.

Im täglichen Einsatz integriert sich git instaweb eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git instaweb --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git instaweb mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git instaweb hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
--httpd=<daemon>	Zu verwendender Webserver.
--port=<n>	Port zum Lauschen (Standard 1234).
--start	Startet den Server.
--stop	Stoppt den Server.
--restart	Startet ihn neu.
--browser=<cmd>	Zu öffnender Browser.

Beispiele

git instaweb --httpd=webrick
    # gitweb mit Rubys WEBrick als Backend starten

    git instaweb --port=8080 --start
    # Auf einem eigenen Port

    git instaweb --stop
    # Abbauen

    git config --global instaweb.httpd webrick
    # Standard für künftige Aufrufe speichern

Häufige Fehler

Fehlende Abhängigkeiten (Perl-Module für gitweb, der gewählte httpd) verursachen kryptische Fehler. Manche Distros liefern gitweb in einem separaten Paket. Für moderne Bedürfnisse ziehen Sie cgit oder gehostete Dienste in Betracht.

Verwandte Befehle

gitweb, git daemon, git http-backend, git config