Projekt zu GitHub hochladen: Schritt für Schritt

01Was Sie vor dem Start brauchen

Ein Projekt auf GitHub hochzuladen heißt, einen Ordner auf Ihrem Rechner in ein Git-Repository zu verwandeln und mit einem Remote-Repository im Internet zu verbinden. Dafür müssen drei Dinge bereitstehen: ein installiertes und eingerichtetes Git, ein GitHub-Konto und eine Authentifizierungsmethode.

Wenn Sie Git noch nicht installiert oder Name, E-Mail und SSH-Schlüssel noch nicht eingerichtet haben, folgen Sie zuerst unserer Anleitung zur Git-Installation. Die Befehle in diesem Beitrag setzen diese Einstellungen voraus.

• Git: Im Terminal sollte git --version eine Versionsnummer ausgeben.
• GitHub-Konto: Es lässt sich kostenlos auf github.com anlegen.
• Authentifizierung: ein SSH-Schlüssel oder, für HTTPS, der Git Credential Manager bzw. ein Personal Access Token. GitHub akzeptiert bei Git-Vorgängen kein Konto-Passwort.
• Ein sauberer Projektordner: Eine .gitignore-Datei hält überflüssige und vertrauliche Dateien fern.

02Repo auf GitHub erstellen

Melden Sie sich bei GitHub an und klicken Sie oben rechts über das Plus-Symbol auf New repository. Wählen Sie einen kurzen, kleingeschriebenen Namen (zum Beispiel firmen-website), ergänzen Sie eine Beschreibung und legen Sie die Sichtbarkeit fest.

Wenn Sie auf Ihrem Rechner bereits ein Projekt haben, fügen Sie weder README noch .gitignore oder Lizenz hinzu; legen Sie das Repository völlig leer an. Andernfalls enthält das Remote-Repository einen Commit, der lokal fehlt, und beim ersten Push kommt es zu Konflikten.

03Mit .gitignore überflüssige Dateien ausschließen

Das Wichtigste vor dem ersten Commit: Legen Sie fest, welche Dateien nicht ins Repository gehören. node_modules, Build-Ordner, Betriebssystemdateien und vor allem .env-Dateien mit Passwörtern oder API-Schlüsseln dürfen niemals auf GitHub landen.

Erstellen Sie im Wurzelverzeichnis des Projekts eine Datei namens .gitignore und tragen Sie Zeilen wie die folgenden ein. Warum Abhängigkeiten nicht ins Repository gehören und welche Rolle die package.json spielt, erklären wir in unserem Beitrag zu den npm-Befehlen.

• Wenn Sie versehentlich eine vertrauliche Datei committet haben, reicht Löschen nicht aus; sie bleibt im Verlauf erhalten. Ändern Sie den betroffenen Schlüssel oder das Passwort sofort.
• Um einen bereits versionierten Ordner nicht mehr zu verfolgen, nutzen Sie git rm -r --cached ordnername, tragen ihn danach in die .gitignore ein und committen die Änderung.

node_modules/
dist/
build/
.env
.env.*
.DS_Store
Thumbs.db
*.log

04Der erste Upload per Kommandozeile

Wechseln Sie im Terminal in den Projektordner und führen Sie die folgenden Befehle nacheinander aus. Die Adresse des Remote-Repositorys finden Sie auf der Seite des leeren GitHub-Repositorys unter der Schaltfläche Code; haben Sie einen SSH-Schlüssel eingerichtet, kopieren Sie die SSH-Adresse, sonst die HTTPS-Adresse.

1. Verwandeln Sie den Ordner mit git init in ein Git-Repository.
2. Nehmen Sie mit git add . alle Dateien in den Staging-Bereich auf.
3. Erstellen Sie mit git commit den ersten Eintrag.
4. Legen Sie den Branch-Namen fest auf main.
5. Verbinden Sie das Remote-Repository mit git remote add origin.
6. Senden Sie alles mit git push -u origin main ab; das Flag -u sorgt dafür, dass bei späteren Pushes ein einfaches git push genügt.

cd proje-klasoru
git init
git add .
git commit -m "Erster Commit"
git branch -M main

# SSH adresi
git remote add origin git@github.com:kullanici-adi/depo-adi.git
# ya da HTTPS adresi
# git remote add origin https://github.com/kullanici-adi/depo-adi.git

git push -u origin main

git remote -v
git status
git log --oneline

05Hochladen mit GitHub Desktop und gh CLI

Die Kommandozeile ist nicht der einzige Weg. Wer eine grafische Oberfläche bevorzugt, nutzt GitHub Desktop; wer im Terminal schneller arbeiten will, erledigt dasselbe in wenigen Schritten mit gh, dem offiziellen Kommandozeilenwerkzeug von GitHub.

GitHub Desktop

Installieren Sie GitHub Desktop und melden Sie sich mit Ihrem Konto an. Wählen Sie im Menü File über Add local repository Ihren Projektordner; ist der Ordner noch kein Repository, bietet die App an, eines zu erstellen. Änderungen sehen Sie im linken Bereich, schreiben unten eine Nachricht und klicken auf Commit. Zum Schluss legt die Schaltfläche Publish repository das Repository auf GitHub an und lädt alles hoch.

gh CLI

Mit gh werden Repository erstellen, verbinden und hochladen zu einem einzigen Befehl. Bei der ersten Nutzung melden Sie sich mit gh auth login über den Browser an.

gh auth login

# Sobald der Ordner mindestens einen Commit enthält
gh repo create depo-adi --private --source=. --remote=origin --push

Mit VS Code

Auch im Bereich Quellcodeverwaltung von VS Code bietet die Schaltfläche Publish to GitHub denselben Ablauf. Zur Einrichtung des Editors und der Git-Integration lesen Sie unsere Anleitung zur VS-Code-Installation.

06Wie sende ich Änderungen nach?

Nach dem ersten Upload besteht der tägliche Ablauf aus drei Befehlen: Änderungen vormerken, speichern, senden. Wenn Sie auf einem anderen Rechner arbeiten oder Ihr Team etwas geändert hat, holen Sie vor dem Arbeitsbeginn mit git pull den aktuellen Stand.

Schreiben Sie Commit-Nachrichten kurz und aussagekräftig: statt »Update« lieber »Telefonfeld zum Kontaktformular hinzugefügt«. Wenn Sie in sechs Monaten auf den Verlauf schauen, erkennen Sie an diesen Nachrichten, was warum geändert wurde.

git pull
git add .
git commit -m "Telefonfeld zum Kontaktformular hinzugefügt"
git push

Mit Branches arbeiten

Nehmen Sie größere Änderungen nicht direkt im main-Branch vor, sondern eröffnen Sie einen neuen Branch: git switch -c neue-funktion. Senden Sie den Branch mit git push -u origin neue-funktion und öffnen Sie auf GitHub einen Pull Request. So wird die Änderung vor dem Zusammenführen geprüft, und main bleibt stets lauffähig.

07Häufige Push-Fehler und ihre Lösungen

Die meisten Fehler bei den ersten Push-Versuchen betreffen die Authentifizierung, den Branch-Namen oder unerwartete Commits im Remote-Repository.

• src refspec main does not match any: Es gibt noch keinen Commit, oder Ihr Branch heißt master. Führen Sie git commit aus oder benennen Sie den Branch mit git branch -M main um.
• remote origin already exists: Das Remote-Repository ist bereits definiert. Um die Adresse zu ändern, verwenden Sie git remote set-url origin neue-adresse.
• rejected (fetch first / non-fast-forward): Im Remote-Repository liegt ein Commit, der lokal fehlt, meist die auf GitHub erzeugte README. Holen Sie ihn mit git pull --rebase origin main und pushen Sie erneut. Sind die Verläufe völlig unabhängig, kann git pull origin main --allow-unrelated-histories nötig sein.
• Permission denied (publickey): Ihr SSH-Schlüssel wurde dem Konto nicht hinzugefügt; testen Sie mit ssh -T git@github.com.
• Fehler bei großen Dateien: GitHub akzeptiert keine einzelnen Dateien über 100 MB. Entfernen Sie Videos und Backups aus dem Repository oder nutzen Sie Git LFS.

08Was GitHub für Unternehmensprojekte bringt

Dass der Code auf GitHub liegt, schützt das Projekt bei Rechnerausfall oder Verlust. Wichtiger noch: Weil jede Änderung nachvollziehbar ist, finden Sie bei einem Fehler auf der Live-Seite schnell den verursachenden Commit und machen ihn rückgängig.

Auch bei einer Website lässt sich messen, was Maßnahmen wie Bildkomprimierung oder Code-Minifizierung für Geschwindigkeit und Performance bringen, wenn Sie sie als eigene Commits speichern. In unseren Projekten für Unternehmenswebsites und Webdesign arbeiten wir mit dieser Disziplin.

Vergessen Sie nicht, dem Repository eine gut geschriebene README hinzuzufügen. Wenige Absätze darüber, was das Projekt tut, wie es installiert und mit welchem Befehl es gestartet wird, sparen einem neuen Teammitglied oder Ihnen selbst nach Monaten Stunden. Führen Sie bei Umgebungsvariablen nur die Namen auf, nicht die Werte.

Weitere Schritt-für-Schritt-Anleitungen finden Sie in der Kategorie Installationsanleitungen.