Weswegen
Tippen, um zu suchen
    Esc zum Schließen · Sofortsuche auf der ganzen Website

    TortoiseGit unter Windows einrichten

    · Weswegen-Redaktion
    Programmierung

    TortoiseGit bindet Git direkt in den Windows Explorer ein: Sie committen, pushen und pullen per Rechtsklick auf einen Ordner, ohne die Kommandozeile zu öffnen. Der wichtigste Punkt gleich vorweg, weil er in vielen Anleitungen untergeht: TortoiseGit bringt kein eigenes Git mit. Es ist nur die grafische Oberfläche (eine sogenannte Shell-Erweiterung) und setzt eine separate Installation von Git for Windows voraus. Wer diese Reihenfolge kennt, ist in zehn Minuten fertig. Diese Anleitung führt Sie von der Installation bis zum ersten Commit und zeigt, wie Sie SSH-Schlüssel und typische Fehler in den Griff bekommen.

    Voraussetzungen

    • Windows 10 oder 11, 64-Bit. Aktuelle TortoiseGit-Versionen werden nur noch als 64-Bit-Build gepflegt.
    • Git for Windows (die eigentliche git.exe) – zwingend erforderlich.
    • Ein Konto bei einem Hosting-Dienst wie GitHub, GitLab oder Bitbucket, falls Sie Repositories im Team teilen wollen.

    Schritt 1: Git for Windows installieren

    TortoiseGit ruft im Hintergrund die echte git.exe auf. Installieren Sie diese also zuerst.

    1. Laden Sie den Installer von gitforwindows.org bzw. git-scm.com/download/win herunter.
    2. Führen Sie das Setup aus. Die Standardvorgaben sind für die meisten Anwender richtig. Zwei Punkte lohnen einen Blick:
      • Zeilenenden: Auf Windows ist „Checkout Windows-style, commit Unix-style line endings“ (core.autocrlf = true) die sichere Wahl, damit CRLF/LF-Konflikte gar nicht erst entstehen.
      • SSH-Client: Belassen Sie es beim mitgelieferten OpenSSH, wenn Sie keinen zwingenden Grund für PuTTY haben.
    3. Merken Sie sich den Installationspfad. Standard ist C:\Program Files\Git, die ausführbare Datei liegt unter C:\Program Files\Git\bin\git.exe.

    Prüfen Sie die Installation, indem Sie eine Eingabeaufforderung öffnen und eingeben:

    git --version

    Eine Ausgabe wie git version 2.xx.x.windows.1 bestätigt, dass Git bereit ist.

    Schritt 2: TortoiseGit installieren

    1. Laden Sie den Installer von tortoisegit.org (Bereich „Download“). Der Hauptdownload ist die 64-Bit-MSI-Datei.
    2. Für eine deutsche Oberfläche laden Sie zusätzlich das Language Pack „Deutsch“ von derselben Seite. Das ist ein separater, kleiner Installer, den Sie nach dem Hauptprogramm ausführen.
    3. Starten Sie die MSI, klicken Sie sich durch den Assistenten und übernehmen Sie die Standardkomponenten. TortoiseGit installiert dabei auch die Zusatzwerkzeuge TortoiseGitMerge (Konfliktlöser), TortoiseGitBlame und die Icon-Overlays.
    4. Nach der Installation ist in der Regel ein Neustart oder Ab- und Anmelden nötig, damit der Explorer die neue Shell-Erweiterung lädt.

    Schritt 3: First-Start-Wizard durchlaufen

    Beim ersten Rechtsklick → TortoiseGit startet ein Konfigurationsassistent, der die entscheidenden Grundeinstellungen abfragt.

    1. Pfad zu Git: Der Assistent sucht git.exe automatisch. Findet er sie nicht, tragen Sie den Ordner von Hand ein – typischerweise C:\Program Files\Git\bin. Genau hier verweigert TortoiseGit den Dienst, wenn Git aus Schritt 1 fehlt.

    2. Name und E-Mail: Diese Angaben landen in jedem Commit und sollten mit Ihrem Hosting-Konto übereinstimmen. Der Assistent schreibt sie in die globale Git-Konfiguration. Dasselbe Ergebnis erzielen Sie auf der Kommandozeile mit:

      git config --global user.name "Ihr Name"
git config --global user.email "ihre@e-mail.de"

    3. SSH-Client: Wählen Sie zwischen OpenSSH (die ssh.exe aus Git for Windows, Standardschlüssel id_ed25519) und TortoiseGitPlink (PuTTY-basiert, arbeitet mit .ppk-Schlüsseln und dem Agenten Pageant). Für Einsteiger ist OpenSSH die unkompliziertere Variante. Die Wahl lässt sich später unter TortoiseGit → Einstellungen → Netzwerk ändern.

    Schritt 4: Ein Repository klonen oder anlegen

    Bestehendes Repository klonen: Rechtsklick in einen leeren Ordner → Git Clone…. Fügen Sie die URL ein (z. B. https://github.com/nutzer/projekt.git) und bestätigen Sie. Unter Windows 11 verbirgt sich der Eintrag zunächst hinter „Weitere Optionen anzeigen“ – oder Sie drücken direkt Umschalt+F10, um das vollständige klassische Kontextmenü zu öffnen.

    Neues Repository anlegen: Rechtsklick im gewünschten Projektordner → Git Create repository here…. TortoiseGit legt einen leeren .git-Ordner an; das entspricht git init auf der Kommandozeile.

    Wollen Sie SSH statt HTTPS verwenden, nutzen Sie eine URL im Format git@github.com:nutzer/projekt.git – dazu muss Ihr öffentlicher Schlüssel beim Hosting-Dienst hinterlegt sein (siehe unten).

    Schritt 5: Der tägliche Ablauf – Commit, Push, Pull

    Sobald ein Ordner unter Versionskontrolle steht, zeigt TortoiseGit den Zustand jeder Datei über Icon-Overlays an: grüner Haken für unveränderte, rotes Ausrufezeichen für geänderte Dateien, ein Plus für neu hinzugefügte.

    • Änderungen sichern: Rechtsklick → Git Commit → „main“…. Der Branchname in Anführungszeichen ist Ihr aktueller Zweig – bei neueren Repositories meist main, bei älteren master. Häkchen bei den gewünschten Dateien setzen, eine aussagekräftige Commit-Nachricht schreiben, Commit klicken. Neue Dateien lassen sich im selben Dialog über „Add“ aufnehmen.
    • Hochladen: Nach dem Commit auf Push klicken (oder Rechtsklick → TortoiseGit → Push…). Beim ersten Push zu einem HTTPS-Remote fragt der Windows-Anmeldeinformationsmanager nach Ihren Zugangsdaten und speichert sie danach.
    • Aktualisieren: Rechtsklick → TortoiseGit → Pull… holt Änderungen der anderen und führt sie zusammen. Fetch lädt nur herunter, ohne zu mergen.
    • Verlauf ansehen: Rechtsklick → TortoiseGit → Show log öffnet die grafische Historie mit Branch-Verlauf, Diffs und der Möglichkeit, einzelne Commits auszuchecken oder zurückzunehmen.

    Den Unterschied zwischen den einzelnen Operationen vertieft unser Beitrag zum aktuellen Git-Status; wie Sie Zweige wieder loswerden, steht unter Git-Branch lokal und remote löschen.

    SSH-Schlüssel einrichten

    Für passwortloses Arbeiten über SSH brauchen Sie ein Schlüsselpaar.

    Variante OpenSSH: In der Git-Bash erzeugen Sie ein Paar mit

    ssh-keygen -t ed25519 -C "ihre@e-mail.de"

    Den Inhalt der Datei ~/.ssh/id_ed25519.pub kopieren Sie in die SSH-Key-Einstellungen von GitHub bzw. GitLab. Der private Schlüssel bleibt auf Ihrem Rechner.

    Variante PuTTY/TortoiseGitPlink: Generieren Sie den Schlüssel mit PuTTYgen, speichern Sie den privaten Teil als .ppk und laden Sie ihn in Pageant (den Schlüsselagenten, der im Infobereich läuft). Ein bereits vorhandener OpenSSH-Schlüssel lässt sich in PuTTYgen über „Import key“ ins .ppk-Format überführen.

    Häufige Probleme und Lösungen

    „git.exe not found“ oder leeres TortoiseGit-Menü: Git for Windows fehlt oder der Pfad stimmt nicht. Korrigieren Sie ihn unter TortoiseGit → Einstellungen → Allgemein → Git.exe-Pfad.

    Icon-Overlays erscheinen nicht: Windows erlaubt systemweit nur 15 Overlay-Handler. Cloud-Dienste wie OneDrive, Dropbox oder Google Drive belegen viele davon, sodass für TortoiseGit keine Slots übrig bleiben. Die Handler liegen in der Registry unter HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers; überzählige oder doppelte Einträge lassen sich dort entfernen (vorher Registry-Zweig exportieren, falls Sie zurück müssen). Anschließend den Explorer-Prozess über den Task-Manager neu starten – ein kompletter Neustart wirkt ebenso zuverlässig.

    SSH-Authentifizierung schlägt fehl: Meist passt der Schlüsseltyp nicht zum gewählten Client. TortoiseGitPlink erwartet .ppk, OpenSSH erwartet den klassischen Schlüssel. Prüfen Sie unter Einstellungen → Netzwerk, welcher SSH-Client eingestellt ist, und ob der Schlüssel im passenden Agenten (Pageant bzw. ssh-agent) geladen ist.

    Push wird abgelehnt („non-fast-forward“): Der Remote enthält Commits, die Ihnen lokal fehlen. Erst Pull, Konflikte lösen, dann erneut Push.

    FAQ

    Brauche ich Git for Windows wirklich zusätzlich, oder reicht TortoiseGit? Sie brauchen beides. TortoiseGit ist reine Oberfläche und ruft die git.exe aus Git for Windows auf. Ohne diese Installation funktioniert nichts – deshalb zuerst Git, dann TortoiseGit.

    Warum sehe ich das TortoiseGit-Menü unter Windows 11 nicht direkt? Windows 11 zeigt anfangs nur ein verkürztes Kontextmenü. Klicken Sie auf „Weitere Optionen anzeigen“ oder drücken Sie Umschalt+F10, um das vollständige Menü mit allen TortoiseGit-Einträgen zu erhalten.

    Kann ich TortoiseGit und die Kommandozeile parallel nutzen? Ja. Beide greifen auf dasselbe Repository und dieselbe Git-Installation zu. Sie können in TortoiseGit committen und im nächsten Moment git status im Terminal ausführen – die Werkzeuge stören sich nicht gegenseitig.

    Ob sich der Umstieg für Sie lohnt, beleuchtet der Beitrag Ist TortoiseGit gut?; den Unterschied zur SVN-Variante klärt Git und TortoiseSVN im Vergleich.