Bei jeder Verbindung zum Server ein Passwort einzutippen nervt schnell, und Passwörter lassen sich erraten. SSH-Schlüssel lösen beide Probleme. Am Ende dieser Anleitung hast du einen ed25519-Schlüssel mit Passphrase, einen Server, der ihn akzeptiert, einen kurzen Alias, damit du einfach ssh myserver tippen kannst, und dasselbe Setup auch für deinen Git-Hoster.
Was du brauchst
- Einen Computer mit macOS, Linux oder Windows 10/11 mit dem integrierten OpenSSH-Client.
- Einen Server oder zweiten Computer, den du bereits mit Benutzername und Passwort erreichst.
- Ein Terminal (Terminal unter macOS, eine beliebige Shell unter Linux, PowerShell unter Windows).
- Etwa 15 Minuten.
Die Beispiele verwenden alice als Benutzernamen, server.example.com als Server und 203.0.113.10 als dessen Adresse. Ersetze sie durch deine eigenen.
Schritt 1: Einen ed25519-Schlüssel erzeugen
Führe das auf dem Computer aus, von dem aus du dich verbinden willst. Die Option -C fügt einen Kommentar hinzu, meist deine E-Mail-Adresse, damit du Schlüssel später auseinanderhalten kannst.
ssh-keygen -t ed25519 -C "alice@example.com"
Aktuelle OpenSSH-Versionen nutzen ed25519 ohnehin als Standard, aber wenn du den Typ angibst, funktioniert der Befehl überall. Drück Enter, um den Standardspeicherort zu übernehmen. Du siehst dann etwa Folgendes:
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/alice/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/alice/.ssh/id_ed25519
Your public key has been saved in /home/alice/.ssh/id_ed25519.pub
Du hast jetzt zwei Dateien. id_ed25519 ist der private Schlüssel. Behandle ihn wie ein Passwort und gib ihn niemals weiter. id_ed25519.pub ist der öffentliche Schlüssel, den du bedenkenlos überallhin kopieren kannst.
Schritt 2: Eine Passphrase setzen und den Schlüssel in den ssh-agent laden
Wenn du nach einer Passphrase gefragt wirst, vergib eine. Falls jemand jemals deinen privaten Schlüssel kopiert, steht ihm die Passphrase immer noch im Weg. Hast du sie übersprungen, kannst du sie später mit ssh-keygen -p -f ~/.ssh/id_ed25519 hinzufügen.
Der ssh-agent merkt sich den entsperrten Schlüssel, sodass du die Passphrase nur einmal pro Sitzung eingeben musst.
macOS
Starte den Agent und füge deinen Schlüssel zum macOS-Schlüsselbund hinzu:
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
Füge dann diese Zeilen zu ~/.ssh/config hinzu (leg die Datei an, falls es sie noch nicht gibt), damit der Schlüssel automatisch geladen wird:
Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
UseKeychain ist eine Ergänzung von Apple und funktioniert deshalb nur unter macOS.
Linux
Viele Desktop-Sitzungen starten bereits einen Agent. Wenn deine das nicht tut, starte einen und füge den Schlüssel hinzu:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Windows
Der ssh-agent-Dienst ist standardmäßig deaktiviert. Öffne PowerShell als Administrator und führe aus:
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
Dann in einem normalen PowerShell-Fenster:
ssh-add $env:USERPROFILE\.ssh\id_ed25519
Schritt 3: Den öffentlichen Schlüssel auf den Server kopieren
Der Server führt eine Liste vertrauenswürdiger öffentlicher Schlüssel in ~/.ssh/authorized_keys. Am einfachsten fügst du deinen mit ssh-copy-id hinzu, das unter macOS und den meisten Linux-Systemen verfügbar ist:
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com
Es fragt ein letztes Mal nach deinem Server-Passwort, legt die Datei bei Bedarf an und überspringt Schlüssel, die bereits eingetragen sind.
Wenn du ssh-copy-id nicht hast, zum Beispiel in Windows PowerShell, kopiere die Schlüsseldatei mit scp hinüber und füge sie dann auf dem Server zur Liste hinzu:
scp $env:USERPROFILE\.ssh\id_ed25519.pub alice@server.example.com:key.pub
ssh alice@server.example.com "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat ~/key.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && rm ~/key.pub"
Diese Befehle gelten für einen Linux- oder macOS-Server. Jeder fragt nach deinem Server-Passwort. Ein Windows-Server speichert Schlüssel an einem anderen Ort, und Administratorkonten verwenden C:\ProgramData\ssh\administrators_authorized_keys. Folge in diesem Fall der unten verlinkten Anleitung von Microsoft.
Schritt 4: Anmelden und den Host-Fingerabdruck prüfen
Verbinde dich jetzt:
ssh alice@server.example.com
Wenn du einen neuen Server zum ersten Mal erreichst, zeigt SSH dessen Fingerabdruck an und bittet dich um Bestätigung:
The authenticity of host 'server.example.com (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:4fXk2...Q9wE.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
Tipp nicht gedankenlos yes ein. Prüfe den Fingerabdruck nach Möglichkeit auf dem Server selbst, über eine Konsole oder eine bestehende Sitzung:
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub
Wenn beide übereinstimmen, gib yes ein. SSH speichert den Schlüssel in ~/.ssh/known_hosts und warnt dich, falls er sich jemals ändert. Du solltest jetzt in einer Shell landen, ohne nach dem Server-Passwort gefragt zu werden. Eventuell wirst du einmal nach der Passphrase deines Schlüssels gefragt, wenn der Agent ihn noch nicht hält.
Schritt 5: Einen Host-Alias in ~/.ssh/config anlegen
Füge auf deinem eigenen Computer einen Eintrag zu ~/.ssh/config hinzu:
Host myserver
HostName server.example.com
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Jetzt reicht das hier:
ssh myserver
IdentitiesOnly yes sorgt dafür, dass SSH nur den Schlüssel anbietet, den du angegeben hast.
Schritt 6: SSH zwischen zwei eigenen Rechnern zu Hause
Dieselben Schritte funktionieren zwischen zwei Computern in deinem Heimnetz. Auf dem Rechner, mit dem du dich verbindest, muss nur ein SSH-Server laufen.
Öffne auf einem Mac die Systemeinstellungen, geh zu „Allgemein“ und dann „Teilen“ und aktiviere Remote Login (Entfernte Anmeldung). Klick auf die Info-Taste daneben, um den genauen ssh-Befehl für diesen Mac zu sehen.
Installiere unter Ubuntu das Server-Paket:
sudo apt install openssh-server
Such die lokale Adresse des Zielrechners in dessen Netzwerkeinstellungen. Kopiere dann vom anderen Computer aus deinen Schlüssel und verbinde dich wie zuvor über diese Adresse. In diesem Beispiel ist es ein Platzhalter:
ssh-copy-id alice@192.168.1.50
ssh alice@192.168.1.50
Schritt 7 (optional): Passwort-Logins abschalten
Sobald die Anmeldung per Schlüssel funktioniert, kannst du den Server so einstellen, dass er gar keine Passwörter mehr annimmt. Bots, die Passwörter erraten, haben dann nichts mehr zu raten.
Lass deine aktuelle SSH-Sitzung dabei offen. Falls etwas schiefgeht, kannst du es über diese offene Sitzung reparieren. Teste von einem zweiten Terminal aus, bevor du irgendetwas schließt.
Unter Ubuntu überschreiben Einstellungen in /etc/ssh/sshd_config.d/ die Hauptdatei, und der zuerst gelesene Wert gewinnt. Die Dateien werden in Namensreihenfolge geladen, ein Name, der mit 00- beginnt, wird also zuerst gelesen:
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf
Füge diese beiden Zeilen hinzu:
PasswordAuthentication no
KbdInteractiveAuthentication no
Prüf die Konfiguration auf Fehler und starte dann den Dienst neu:
sudo sshd -t
sudo systemctl restart ssh.service
Führe in einem neuen Terminal ssh myserver aus, um sicherzugehen, dass du noch reinkommst. Probier dann ssh -o PubkeyAuthentication=no myserver. Das sollte abgelehnt werden. Die Software des Servers aktuell zu halten ist genauso wichtig.
Schritt 8: Einen Git-Hoster verbinden
Git-Hoster wie GitHub akzeptieren denselben Schlüssel. Gib deinen öffentlichen Schlüssel aus und kopiere ihn:
cat ~/.ssh/id_ed25519.pub
Füge ihn im Bereich für SSH-Schlüssel deiner Kontoeinstellungen ein und folge dabei der Anleitung deines Git-Hosters (die von GitHub ist unten verlinkt). Teste dann:
ssh -T git@github.com
Ein erfolgreicher Test sieht so aus:
Hi alice! You've successfully authenticated, but GitHub does not provide shell access.
Dein Git-Konto ist ein wichtiger Teil deiner Online-Identität, deshalb lohnt es sich, auch deine übrigen Konten zu überprüfen.
Häufige Fehler und Lösungen
Permission denied (publickey)
Der Server hat keinen der angebotenen Schlüssel akzeptiert. Prüfe, ob der öffentliche Schlüssel auf dem Server in ~/.ssh/authorized_keys steht, ob du den richtigen Benutzernamen verwendest und ob der Agent deinen Schlüssel hält. Mit ssh -v myserver siehst du, welche Schlüssel ausprobiert werden.
Falsche Berechtigungen für ~/.ssh
Standardmäßig ignoriert der SSH-Server deine Schlüssel, wenn deine Dateien zu offen sind. Korrigiere das auf dem Server mit:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
WARNING: UNPROTECTED PRIVATE KEY FILE!
Dein privater Schlüssel ist für andere Benutzer lesbar, deshalb weigert sich SSH, ihn zu verwenden. Führe auf deinem eigenen Computer aus:
chmod 600 ~/.ssh/id_ed25519
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
Der Schlüssel des Servers passt nicht mehr zu dem in known_hosts. Das passiert, wenn ein Server neu installiert wurde, kann aber auch auf einen Angriff hindeuten. Vergewissere dich, dass die Änderung erwartet ist, entferne dann den alten Eintrag und verbinde dich neu:
ssh-keygen -R server.example.com
The agent has no identities
Diese Meldung zeigt ssh-add -l, wenn der Agent läuft, aber keine Schlüssel hält. Füge deinen mit ssh-add ~/.ssh/id_ed25519 erneut hinzu. Wenn du „Could not open a connection to your authentication agent“ siehst, starte zuerst den Agent, wie in Schritt 2 gezeigt.
Fazit
Du meldest dich jetzt mit einem Schlüssel statt mit einem Passwort an, dein Schlüssel ist durch eine Passphrase geschützt, und ein Alias hält die Befehle kurz. Verwende einen Schlüssel pro Computer, statt einen privaten Schlüssel herumzukopieren. Geht ein Gerät verloren, lösch die Zeile mit seinem öffentlichen Schlüssel aus authorized_keys und bei deinem Git-Hoster.
Wenn sich die Anmeldung per Schlüssel erst einmal normal anfühlt, helfen dir dieselben Terminal-Gewohnheiten auch bei neueren Entwickler-Setups. Unsere Anleitung zu Chrome DevTools MCP zeigt, wie du einem Coding-Agent einen echten Browser gibst.
Quellen und offizielle Dokumentation
Links zuletzt geprüft am 15. November 2026.
- OpenSSH ssh-keygen manual
- OpenSSH ssh manual
- OpenSSH ssh_config manual
- OpenSSH sshd_config manual
- ssh-copy-id manual page
- GitHub Docs: Generating a new SSH key and adding it to the ssh-agent
- GitHub Docs: Testing your SSH connection
- Microsoft Learn: Key-based authentication in OpenSSH for Windows
- Ubuntu Server docs: OpenSSH server
- Apple Support: Allow a remote computer to access your Mac





Kommentar schreiben