Git Remote
Zuletzt aktualisiert
git remote verwaltet die Kurznamen, die dein Repository für Remote-Repositories verwendet - am häufigsten origin, das auf dein GitHub-Repository zeigt. Du verwendest es, um zu Beginn ein Remote hinzuzufügen, die vorhandenen aufzulisten, sie umzubenennen oder zu entfernen und die URL eines Remotes zu ändern (zum Beispiel von HTTPS auf SSH umzustellen).
Probiere das im Terminal-Playground aus - eine echte Shell in deinem Browser, nichts zu installieren.
Syntax
| Command | What it does |
|---|---|
git remote -v | Listet Remotes mit ihren URLs auf |
git remote add origin <url> | Fügt ein Remote namens origin hinzu |
git remote set-url origin <url> | Ändert die URL eines Remotes |
git remote rename origin upstream | Benennt ein Remote um |
git remote remove origin | Entfernt ein Remote |
git remote show origin | Zeigt Details zu einem Remote an |
Häufige Fälle
| Goal | Command |
|---|---|
| Ein neues Repository mit GitHub verbinden | git remote add origin <url> |
| Von HTTPS auf SSH umstellen | git remote set-url origin git@github.com:... |
| Prüfen, worauf origin zeigt | git remote -v |
Praxisbeispiel
| Schritt | Befehl | Ergebnis |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | Registriert das GitHub-Repository unter dem Namen origin |
| 2 | git remote -v | Listet origin mit seinen URLs für fetch und push auf |
| 3 | git push -u origin main | Lädt main hoch und lässt es origin/main verfolgen |
git remote FAQ
Was ist ein Git-Remote?
Ein Remote ist eine benannte Referenz auf ein Repository, das anderswo gehostet wird - typischerweise auf GitHub, GitLab oder einem Server. Der Standardname ist
origin. Remotes sind das, womit sich git push, git pull und git fetch synchronisieren. git remote ist der Befehl zum Verwalten dieser benannten Referenzen.Wie füge ich ein Remote hinzu?
Führe
git remote add origin <url> mit der URL des Repositories aus. Das verknüpft dein lokales Repository unter dem Namen origin mit dem Remote. Danach kannst du mit git push -u origin main pushen. Verwende einen anderen Namen (etwa upstream), wenn origin bereits vergeben ist.Wie ändere ich die URL eines Remotes?
Verwende
git remote set-url origin <new-url>. So stellst du ein Repository von einer HTTPS-URL auf eine SSH-URL um (oder aktualisierst sie, nachdem ein Repository umbenannt wurde), ohne das Remote zu entfernen und neu hinzuzufügen. Überprüfe es mit git remote -v.Wie sehe ich meine Remotes?
Führe
git remote -v aus, um jedes Remote mit seinen Fetch- und Push-URLs aufzulisten. Für eine detaillierte Ansicht eines Remotes - einschließlich seiner getrackten Branches - verwende git remote show origin.Was macht git remote add origin?
Der Befehl speichert eine URL unter dem Namen
origin in der Konfiguration deines Repositorys. Dabei wird noch nichts hoch- oder heruntergeladen: Er legt nur den Namen an, damit du später git push origin main statt der vollen URL tippen kannst. Gibt es origin schon, verweigert Git den Befehl mit „remote origin already exists“; mit git remote set-url origin <url> lässt du den Namen dann auf eine andere Adresse zeigen.Was ist der Unterschied zwischen origin und upstream?
Beides sind nur übliche Namen.
origin ist das Remote, von dem du geklont oder auf das du zuerst gepusht hast, meist deine eigene Kopie. Wenn du ein Projekt forkst, wird das Original-Repository oft mit git remote add upstream <url> als zweites Remote namens upstream hinzugefügt. So kannst du dessen Änderungen holen und trotzdem in deinen Fork pushen.Wie hole ich einen Branch von einem Remote?
Führe
git fetch origin aus, um alle Branches herunterzuladen, und dann git switch <branch>, um einen lokalen Branch anzulegen, der origin/<branch> verfolgt. Die Varianten zeigt die Seite Remote-Branch auschecken.Kann ich das online üben?
Ja. Öffne den Terminal-Playground, um
git remote in einer echten Shell in deinem Browser auszuführen - nichts zu installieren. Coddys kostenloser interaktiver Git-Kurs behandelt das Verbinden mit Remotes ebenfalls Schritt für Schritt.