====== Gitea: Push-Zugang einrichten ======
Diese Seite gehört zu [[infrastruktur:onlinedienste|Online Dienste]] und erklärt, wie du von deinem Rechner aus auf [[https://git.sternenlabor.de|Gitea]] pushen kannst.
Die Anmeldung über Authentik (SSO) funktioniert **nur im Browser**. Git auf dem eigenen Rechner fragt das SSO-Fenster nicht ab – ein zusätzliches Credential in Gitea ist deshalb nötig, sonst schlägt jeder Push fehl. Wähle **eine** der beiden Optionen:
===== Option A: Access-Token (einfach, für Einsteiger empfohlen) =====
- Öffne [[https://git.sternenlabor.de]] und melde dich an (SSO).
- Klicke oben rechts auf dein **Avatar-Bild** → **Einstellungen**, dann im Menü den Punkt **Anwendungen** (direkter Link: [[https://git.sternenlabor.de/user/settings/applications]]).
- Klicke auf **Token generieren**.
- Gib dem Token einen Namen, z. B. „laptop“, und lass die Berechtigungen unverändert. Bestätige mit **Token generieren**.
- **Kopiere den Token sofort** – er wird nur einmal angezeigt! Am besten im Passwortmanager ablegen.
Wenn Git beim Push nach einem Passwort fragt, gibst du deinen Gitea-Benutzernamen (vorname.nachname) ein und fügst den Token als Passwort ein. Windows und macOS merken sich das nach dem ersten Mal.
Klonen geht dann ganz normal:
git clone https://git.sternenlabor.de/BENUTZER/REPO.git
===== Option B: SSH-Key (wenn du mit dem Terminal vertraut bist) =====
Lege zuerst in einem Terminal einen Schlüssel an. Bei der Frage nach einem Passwort kannst du einfach Enter drücken:
ssh-keygen -t ed25519
Zeige dann den öffentlichen Schlüssel an und kopiere die **gesamte Zeile**. Unter Windows funktioniert das in PowerShell genauso:
cat ~/.ssh/id_ed25519.pub
Füge den Schlüssel anschließend in Gitea ein: [[https://git.sternenlabor.de]] → **Avatar-Bild** oben rechts → **Einstellungen** → **SSH/GPG-Schlüssel** (direkter Link: [[https://git.sternenlabor.de/user/settings/keys]]). Schlüssel einfügen und auf **Schlüssel hinzufügen** klicken.
Klone Repositorien mit der ssh-Adresse:
git clone git@git.sternenlabor.de:BENUTZER/REPO.git
**Wichtig:** Token und SSH-Key sind persönlich. Weitergeben, in Repositorien oder im Wiki ablegen – niemals. Verlorene Token kannst du in den Einstellungen jederzeit löschen und neu erzeugen.