server:gitea:wie_arbeiten:troubleshooting:start
Inhaltsverzeichnis
Git Troubleshooting
SSH‑Key‑Probleme
Problem: „Permission denied (publickey)“
Ursache: Der SSH‑Key ist nicht im Agent, nicht auf dem Server oder du verwendest den falschen Key.
Lösungsschritte:
- Prüfen, ob ein Key existiert
dir ~/.ssh
Erwartet: id_ed25519 und id_ed25519.pub - SSH‑Agent starten <code bash>eval $(ssh-agent -s)</code> - Key hinzufügen <code bash>ssh-add ~/.ssh/id_ed25519</code> - Public Key in Gitea eintragen * Gitea → Benutzerprofil → SSH‑Keys * Inhalt von id_ed25519.pub einfügen - Verbindung testen <code bash>ssh -T git@<dein-gitea-host></code>
Problem: „Host key verification failed“
Ursache: Der Server ist neu oder der Fingerprint hat sich geändert.
Lösung:
ssh-keygen -R <gitea-host> ssh <gitea-host>
→ Fingerprint bestätigen
Problem: VS Code / Visual Studio nutzt falschen SSH‑Key
Lösung:
In ~/.ssh/config:
Host gitea
HostName <dein-host>
User git
IdentityFile ~/.ssh/id_ed25519
Merge‑Konflikte
Problem: „CONFLICT: Merge conflict in <datei>“
Ursache: Zwei Personen haben dieselbe Stelle geändert.
Konfliktmarkierungen im Code
<<<<<<< HEAD deine Änderungen ======= Änderungen vom anderen Branch >>>>>>> feature/login
Lösungsschritte:
- Datei öffnen
- Konfliktbereiche manuell korrigieren
- Konfliktmarkierungen entfernen
- Datei als gelöst markieren:
git add <datei>
- Merge abschließen:
git commit
Problem: Merge zu komplex / unübersichtlich
Lösung:
Merge abbrechen
git merge --abort
Problem: Visual Studio zeigt Konflikte nicht sauber an
Lösung:
- Menü: Git → Konflikte → Konflikt lösen
- Alternativ: VS Code öffnen (bessere Konfliktansicht)
Push‑Fehler
Fehler: „non-fast-forward“ oder „rejected“
Ursache: Auf dem Server gibt es neue Commits, die du lokal nicht hast.
Lösung:
git pull
→ Konflikte lösen → Commit → Push
Fehler: „Updates were rejected because the remote contains
Ursache: Du hast lokal Commits, die nicht auf dem Server sind.
Lösung:
git pull --rebase git push
Alternative (wenn Merge gewünscht)
git pull git push
Fehler: „You are not allowed to push to this repository“
Ursache:
- Falscher Benutzer
- Keine Schreibrechte
- Falscher Branch (z. B. main geschützt)
Lösung:
- Gitea → Repository → Settings → Branch Protection prüfen
- Schreibrechte prüfen
- Branch wechseln:
git checkout <feature-branch>
Fehler: „fatal: Authentication failed“
Ursache: Bei HTTPS: falsches Passwort oder Token fehlt.
Lösung:
- In Gitea → Benutzerprofil → Tokens
- Neuen Token erstellen
- Git‑Credential‑Manager aktualisieren:
git credential-manager reject https://<gitea-host>
Allgemeine Reparaturbefehle
Lokales Repo „reparieren“
git fetch --all git reset --hard origin/main
Staging zurücksetzen
git restore --staged <datei>
Datei wiederherstellen
git restore <datei>
server/gitea/wie_arbeiten/troubleshooting/start.txt · Zuletzt geändert: von 91.115.86.136
