Übersicht

git remote [-v]
git remote add <name> <url>
git remote remove <name>
git remote set-url <name> <url>

Beschreibung

Der git remote-Befehl verwaltet die Menge der Repositories ("Remotes"), deren URLs in Ihrer lokalen Konfiguration gespeichert sind. Jeder Remote hat einen kurzen Spitznamen (üblicherweise origin für die ursprüngliche Klon-Quelle und upstream für das Projekt, von dem Sie geforkt haben). Wenn Sie git fetch origin, git push origin oder Ähnliches ausführen, wird der Spitzname zur URL aufgelöst.

Remotes werden in .git/config gespeichert und können separate URLs für Fetch und Push haben. Sie tragen auch Refspecs, die festlegen, welche Refs gefetcht werden und in welchen lokalen Namespace. Moderne Workflows haben oft nur origin, während Open-Source-Mitwirkende üblicherweise sowohl origin (ihren Fork) als auch upstream (das kanonische Projekt) haben.

Im täglichen Einsatz integriert sich git remote 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 remote --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 remote 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 remote hilft, alle drei zu vermeiden.

Häufige Optionen

Option / Unterbefehl	Beschreibung
-v, --verbose	Zeigt URLs neben Remote-Namen.
add <name> <url>	Registriert einen neuen Remote.
remove <name>	Entfernt einen Remote aus der Konfiguration.
rename <old> <new>	Benennt einen Remote um.
set-url <name> <url>	Ändert die URL eines Remotes.
show <name>	Zeigt detaillierte Informationen zu einem Remote an.
prune <name>	Löscht veraltete Remote-Tracking-Refs.

Beispiele

git remote -v
    # Alle Remotes mit URLs auflisten

    git remote add upstream https://github.com/original/project.git
    # Den Upstream-Repo eines Forks hinzufügen

    git remote set-url origin [email protected]:me/project.git
    # Von HTTPS auf SSH umstellen

    git remote prune origin
    # Tracking-Branches entfernen, die auf origin nicht mehr existieren

Häufige Fehler

Eine falsche URL hinzufügen (Tippfehler, fehlendes .git-Suffix bei manchen Hosts) führt zu verwirrenden Fetch-Fehlern. Führen Sie git remote -v zur Bestätigung aus. Nach Repository-Umbenennungen oder Fork-Eigentümerwechseln werden Ihre Remote-URLs veraltet — beheben Sie das mit set-url. Vergessen Sie nicht, periodisch git remote prune auszuführen, um auf dem Server gelöschte Branches aufzuräumen.

Verwandte Befehle

git fetch, git push, git pull, git ls-remote