Benutzer-Werkzeuge

Webseiten-Werkzeuge


server:gitea:wie_arbeiten:troubleshooting:start

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:

  1. 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:

  1. Datei öffnen
  2. Konfliktbereiche manuell korrigieren
  3. Konfliktmarkierungen entfernen
  4. Datei als gelöst markieren:
git add <datei>
  1. 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ü: GitKonflikteKonflikt 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ösenCommitPush

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