Ubuntu und GitHub: Komplette Anleitung zur Einrichtung, Nutzung und Fehlerbehebung

1. Einführung

Warum Ubuntu mit GitHub verbinden?

In den letzten Jahren ist die Nutzung von Git und GitHub im Bereich Softwareentwicklung und Systemadministration zur Selbstverständlichkeit geworden. Besonders für Entwickler und Programmierer, die eine Linux-Umgebung wie Ubuntu nutzen, gehört die Integration von GitHub in den Arbeitsalltag.

Git ist ein Tool zur Versionskontrolle von Quellcode und unerlässlich für die effiziente Zusammenarbeit mehrerer Entwickler. GitHub hingegen ist ein Hosting-Service, der es ermöglicht, mit Git verwaltete Repositories im Internet zu teilen und zu veröffentlichen. Es fungiert als Drehscheibe für den Codeaustausch mit Entwicklern weltweit.

Warum sollte man GitHub unter Ubuntu nutzen?

Ubuntu ist eine der beliebtesten Linux-Distributionen unter Entwicklern und perfekt für Open-Source-Projekte geeignet. Die Installation von Git und anderen Entwickler-Tools ist einfach, sodass auch die Verbindung zu GitHub reibungslos funktioniert.

Typische Anwendungsfälle für die Kombination von Ubuntu und GitHub sind zum Beispiel:

• Verwaltung und Teilen von Code (z. B. Python oder C++) auf GitHub
• Mitarbeit (Contribution) an Open-Source-Projekten
• Veröffentlichung eigener Projekte als Portfolio

Was Sie in diesem Artikel lernen werden

In diesem Leitfaden erklären wir Ihnen Schritt für Schritt von den Grundlagen bis zu fortgeschrittenen Anwendungen, wie Sie GitHub unter Ubuntu nutzen.

• Installation von Git unter Ubuntu
• Erste Git-Konfiguration und Einrichten der SSH-Verbindung
• Repository-Erstellung und Bedienung auf GitHub
• Effiziente Entwicklung durch Integration mit Visual Studio Code
• Problemlösungen & häufige Fragen (FAQ)

Auch wenn Sie GitHub zum ersten Mal nutzen, können Sie diesem Leitfaden problemlos folgen. Praxisnahe Beispiele und wichtige Hinweise sind integriert. Wenn Sie als Ubuntu-Nutzer GitHub optimal nutzen möchten, lesen Sie unbedingt bis zum Schluss weiter.

2. Installation von Git auf Ubuntu

Was ist Git? Noch einmal kurz erklärt

Git ist ein Versionskontrollsystem (VCS: Version Control System) für die Softwareentwicklung. Es verwaltet die Änderungshistorie von Quellcode, ermöglicht die Wiederherstellung älterer Zustände und parallele Arbeit im Team.

Ein großer Vorteil von Ubuntu und anderen Linux-Distributionen ist die besonders einfache Installation von Git. Mit der folgenden Methode können Sie Git in wenigen Minuten über das Terminal installieren.

Git-Installation über APT

Für die Installation von Git unter Ubuntu empfiehlt sich die Nutzung von APT (Advanced Package Tool). Gehen Sie folgendermaßen vor:

1. Paketlisten aktualisieren

sudo apt update

Mit diesem Befehl wird die Paketliste aktualisiert. Führen Sie diesen Schritt immer vor der Installation aus.

2. Git installieren

sudo apt install git

Wenn die Installation mit „Y/n“ bestätigt werden muss, geben Sie „y“ ein und drücken Enter. Die Installation beginnt.

Installation überprüfen

Nach der Installation prüfen Sie mit folgendem Befehl, ob Git korrekt installiert wurde:

git --version

Wenn z. B. Folgendes erscheint, ist alles in Ordnung:

git version 2.34.1

Die Versionsnummer kann je nach Ubuntu-Version abweichen, aber solange eine Version angezeigt wird, war die Installation erfolgreich.

Installation über Snap (optional)

Unter Ubuntu können Sie Git auch mit dem snap-Befehl installieren. APT gilt jedoch als Standard und ist stabiler. Wenn kein besonderer Grund besteht, wird die Installation über APT empfohlen.

3. Erste Git-Konfiguration

Wichtige Grundeinstellungen vor dem ersten Einsatz

Nach der Installation sollten Sie Benutzerdaten und Authentifizierungsmethoden einrichten. Diese Einstellungen sorgen für reibungslose Zusammenarbeit mit Remote-Repositories und Teams.

Benutzername und E-Mail für Git festlegen

Git speichert bei jedem Commit (Änderung) die Information, wer die Änderung vorgenommen hat. Deshalb sollten Sie Name und E-Mail vorab konfigurieren.

Befehle zur Konfiguration

git config --global user.name "Ihr Name"
git config --global user.email "you@example.com"

Der Name und die E-Mail müssen nicht mit Ihrem GitHub-Konto übereinstimmen, aber eine Übereinstimmung ist für die Zuordnung der Commits zu Ihrem Benutzerprofil sinnvoll.

Einstellungen überprüfen

git config --list

Mit diesem Befehl können Sie die aktuelle Konfiguration einsehen.

SSH-Key generieren und bei GitHub hinterlegen

HTTPS-Verbindungen sind möglich, SSH empfiehlt sich jedoch, da keine Passworteingabe erforderlich ist und die Nutzung sicherer und komfortabler ist.

1. SSH-Key generieren

ssh-keygen -t ed25519 -C "you@example.com"

Befolgen Sie die Anweisungen, drücken Sie mehrmals Enter. Ein Schlüsselpaar ~/.ssh/id_ed25519 (privat) und ~/.ssh/id_ed25519.pub (öffentlich) wird erstellt.

2. SSH-Agent starten und Schlüssel hinzufügen

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Jetzt ist der Schlüssel einsatzbereit.

3. Öffentlichen Schlüssel bei GitHub hinzufügen

Kopieren Sie den Inhalt des öffentlichen Schlüssels:

cat ~/.ssh/id_ed25519.pub

Kopieren Sie die gesamte Ausgabe und fügen Sie diese auf GitHub wie folgt hinzu:

1. Bei GitHub anmelden
2. Profilbild → „Settings“ auswählen
3. Links „SSH and GPG keys“ wählen
4. Auf „New SSH key“ klicken, Schlüssel einfügen und speichern

4. SSH-Verbindung testen

Verbindung wie folgt testen:

ssh -T git@github.com

Beim ersten Mal erscheint die Frage „Trust this host?“ – mit „yes“ bestätigen.
Bei Erfolg erscheint folgende Meldung:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Empfohlene Aktionen nach der Einrichtung

Mit diesen Einstellungen können Sie Repositories auf GitHub klonen, pushen und pullen. Im nächsten Abschnitt erklären wir, wie Sie ein Repository auf GitHub erstellen und bedienen.

4. Arbeiten mit GitHub-Repositories

Neues Repository auf GitHub anlegen

Melden Sie sich bei GitHub an und erstellen Sie ein neues Repository.

Erstellung im Webbrowser

1. Oben rechts auf der GitHub-Startseite auf das „+“-Symbol → „New repository“
2. Folgende Informationen ausfüllen:

• Repository-Name: z. B. my-first-repo
• Beschreibung (optional): kurze Erklärung
• Public / Private: Öffentlich oder Privat wählen

1. Auf „Create repository“ klicken

Nach der Erstellung wird die Repository-URL angezeigt. Mit dieser URL können Sie z. B. klonen.

Ein bestehendes Repository klonen

Um das Repository lokal auf Ubuntu zu kopieren, nutzen Sie den git clone-Befehl:

git clone git@github.com:your-username/my-first-repo.git

Dies ist ein Beispiel für eine SSH-Verbindung. Für HTTPS ist die URL anders.

Nach Ausführung des Befehls wird im aktuellen Verzeichnis ein Ordner my-first-repo mit dem Repository-Inhalt erstellt.

Dateien ändern, zum Staging hinzufügen und Committen

1. Datei hinzufügen oder bearbeiten

Beispiel für eine neue Datei:

echo "# Erste Schritte mit GitHub" > README.md

2. Änderungen zum Staging hinzufügen

git add README.md

Staging bedeutet, dass die Änderungen für den nächsten Commit vorgemerkt werden.

3. Änderungen committen

git commit -m "Erster Commit: README.md hinzugefügt"

Damit werden die Änderungen lokal gespeichert.

Änderungen zu GitHub hochladen (Push)

Um die lokalen Änderungen auf das Remote-Repository (GitHub) zu übertragen, verwenden Sie git push:

git push origin main

Wenn Ihr Standard-Branch anders heißt (z. B. master), passen Sie den Namen entsprechend an.

Änderungen vom Remote-Repository holen (Pull)

Wenn andere Entwickler Änderungen im Remote-Repository vorgenommen haben, holen Sie diese wie folgt:

git pull origin main

Damit werden die Remote-Änderungen mit Ihrem lokalen Branch synchronisiert.

Weitere hilfreiche Befehle

• Remote-Repositories anzeigen:

git remote -v

• Ein weiteres Remote-Repository hinzufügen:

git remote add origin git@github.com:your-username/another-repo.git

• Auch README.md oder .gitignore können so verwaltet werden.

5. Integration mit Visual Studio Code

VS Code: Die ideale Entwicklungsumgebung für Git

Wenn Sie GitHub unter Ubuntu nutzen, empfiehlt sich Visual Studio Code (kurz: VS Code), um die Produktivität zu steigern. VS Code ist ein Open-Source-Code-Editor von Microsoft und bietet eine nahtlose Integration mit Git. Sie können im GUI Änderungen committen, pushen und vergleichen – besonders für Einsteiger ideal.

Installation von VS Code unter Ubuntu

So installieren Sie VS Code auf Ubuntu:

1. Microsoft-Repository hinzufügen

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Repository-Informationen registrieren

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. VS Code installieren

sudo apt update
sudo apt install code

Nach der Installation starten Sie den Editor einfach mit code im Terminal.

Git-Funktionen sind standardmäßig integriert

VS Code bietet direkt nach der Installation integrierte Git-Funktionen. Für fortgeschrittene Nutzung empfehlen sich folgende Erweiterungen:

• GitHub Pull Requests and Issues
  → Erleichtert Pull-Request- und Issue-Verwaltung direkt im Editor
• GitLens
  → Zeigt die Änderungsverläufe pro Zeile und hilft beim Nachverfolgen von Änderungen

Grundlegende Git-Operationen in VS Code

Repository öffnen

Wechseln Sie im Terminal in Ihr Projektverzeichnis und führen Sie aus:

code .

Dadurch öffnet VS Code das gesamte Repository.

Änderungen prüfen und committen

• Klicken Sie auf das Symbol „Quellcodeverwaltung“ (verzweigter Strich) links
• Geänderte Dateien werden angezeigt
• Durch Klick auf die Datei sehen Sie die Änderungen
• Commit-Nachricht eingeben und auf das „✓“-Symbol klicken

Push- und Pull-Befehle

• Im Menü „…“ links „Push“ oder „Pull“ auswählen
• Alternativ im unteren Statusbalken bedienen

Kombination mit Terminal möglich

Das integrierte Terminal (Ctrl +) in VS Code ermöglicht es, GUI und Kommandozeile flexibel zu kombinieren – zum Beispiel Commit per GUI, Branch-Operationen im Terminal.

Hilfreiche Tipps bei Problemen

• Bei SSH-Fehlern prüfen, ob VS Code auf den richtigen SSH-Key zugreift
• Authentifizierungsdaten ggf. neu setzen oder Personal Access Token (PAT) von GitHub generieren

6. Häufige Fehlerbehebung

SSH-Verbindungsfehler: „Permission denied (publickey).“

Mögliche Ursachen

• SSH-Key wurde nicht richtig generiert oder registriert
• Der öffentliche Schlüssel fehlt bei GitHub
• SSH-Agent erkennt den Schlüssel nicht

Lösung

1. Vorhandensein des SSH-Keys prüfen:

   ls ~/.ssh/id_ed25519.pub

Wenn nicht vorhanden, so erzeugen:

   ssh-keygen -t ed25519 -C "your_email@example.com"

2. SSH-Agent starten und Schlüssel hinzufügen:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519

3. Öffentlichen Schlüssel bei GitHub hinterlegen:

   cat ~/.ssh/id_ed25519.pub

→ Auf GitHub unter „SSH and GPG keys“ einfügen

4. Verbindung testen:

   ssh -T git@github.com

Authentifizierungsfehler (HTTPS): Benutzername oder Passwort wird abgefragt

Grund

• Passwort-Authentifizierung ist abgeschafft, Token-Authentifizierung ist erforderlich

Lösung

1. „Personal Access Token“ auf GitHub generieren
   → https://github.com/settings/tokens
   → repo auswählen und erstellen
2. Beim Authentifizieren: GitHub-Benutzername, als Passwort den generierten Token verwenden
3. Um Anmeldedaten zu speichern, Caching aktivieren:

   git config --global credential.helper cache

Fehler: „fatal: not a git repository“

Grund

• Der aktuelle Ordner ist kein Git-Repository

Lösung

• In das geklonte Repository wechseln:

  cd ~/your-project-directory

• Oder neues Repository initialisieren:

  git init

Konflikte beim Zusammenführen (Merge Conflicts)

Grund

• Gleichzeitige Änderungen an derselben Datei/Stelle durch verschiedene Personen

Lösung

1. Bei Fehler nach git pull die betroffene Datei öffnen
2. Sie sehen Markierungen wie:

   <<<<<<< HEAD
   Ihre Änderungen
   =======
   Änderungen von anderen
   >>>>>>> origin/main

3. Entscheiden Sie, welche Änderungen bleiben sollen, Markierungen entfernen und speichern
4. Anschließend:

   git add .
   git commit

Fehler: „remote: Repository not found.“

Grund

• Falsche Repository-URL
• Kein Zugriffsrecht auf das Repository

Lösung

• Remote-URL prüfen:

  git remote -v

• Gegebenenfalls neu setzen:

  git remote set-url origin git@github.com:your-username/your-repo.git

Diese Fehler sind typische Stolpersteine für Einsteiger. Wenn Sie Ursache und Lösung kennen, lassen sie sich schnell beheben. Jeder Fehler ist eine Lernchance – mit etwas Übung werden Sie sicherer.

7. FAQ (Häufig gestellte Fragen)

Q1. Was ist der Unterschied zwischen Git und GitHub?

A:
Git ist ein Versionskontrollwerkzeug zur lokalen Verwaltung von Quellcode-Änderungen. GitHub ist ein Online-Service zum Teilen und Verwalten von Git-Repositories im Internet.

• Git: Lokale Versionskontrolle, offline möglich
• GitHub: Speicherung und Teilen der Historie in der Cloud, Zusammenarbeit mit anderen

Q2. Sollte ich SSH oder HTTPS für die Verbindung nutzen?

A:
SSH wird empfohlen, denn:

• Keine wiederholte Passworteingabe (SSH-Schlüssel für Authentifizierung)
• Sicherer und komfortabler für längere Nutzung

Abhängig von Unternehmensrichtlinien oder Netzwerkumgebung kann auch HTTPS erforderlich sein. Wählen Sie entsprechend.

Q3. Wie verwalte ich mehrere GitHub-Konten auf Ubuntu?

A:
Für jedes Konto einen eigenen SSH-Key erstellen und die Nutzung in der SSH-Konfigurationsdatei festlegen.

1. SSH-Keys je Account erstellen
   z. B.: ~/.ssh/id_ed25519_work, ~/.ssh/id_ed25519_personal
2. Folgendes in ~/.ssh/config eintragen:

   Host github.com-work
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_work

   Host github.com-personal
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_personal

3. Im .git/config oder mit git remote set-url das Remote-URL ändern:

   git remote set-url origin git@github.com-work:your-work-user/your-repo.git

Q4. Kann ich Git auch komplett über eine GUI bedienen?

A:
Ja, Visual Studio Code ermöglicht eine intuitive Git-Bedienung über die Oberfläche: Commit, Push, Diff, Branches etc. – alles per Klick. Für Einsteiger besonders empfehlenswert.

Q5. Was passiert mit meinem lokalen Repository, wenn ich das Remote-Repository auf GitHub lösche?

A:
Das lokale Repository bleibt erhalten, aber git push führt zu einem Fehler.

Um das lokale Repository mit einem neuen Remote zu verbinden, setzen Sie die URL so:

git remote set-url origin git@github.com:new-user/new-repo.git

Q6. Ich habe Schwierigkeiten mit dem Terminal – gibt es reine GUI-Tools?

A:
Folgende GUI-Git-Clients ermöglichen komfortable Bedienung ohne Terminal:

• GitKraken
• Sourcetree (offiziell nicht für Linux, läuft teils mit Wine)
• Visual Studio Code (mit integrierter Git-Unterstützung)

Für Ubuntu empfiehlt sich besonders die Kombination VS Code + GitLens-Erweiterung.

Q7. Wie weit reicht die Git-Historie zurück?

A:
Git speichert alle Commits seit der Initialisierung des Repositories. Mit folgendem Befehl sehen Sie die Historie:

git log

Nur die Historie einer bestimmten Datei anzeigen:

git log path/to/file