# SSH Alias anlegen

Unter Windows kannst du für SSH-Server-Aliase die Datei `~/.ssh/config` verwenden – genauso wie unter Linux oder macOS. Damit kannst du z. B. einem GitLab-Server auf einem speziellen Port (wie 2022) einen Alias geben.

### So richtest du den Alias ein:

1. Öffne den Windows-Dateiexplorer und gehe zu deinem Benutzerverzeichnis:
    
    ```
    C:\Users\<deinBenutzername>\.ssh
    
    ```
    
    Falls der Ordner `.ssh` noch nicht existiert, kannst du ihn anlegen.
2. Öffne (oder erstelle) darin die Datei `config` (ohne Dateiendung) mit einem Texteditor wie Notepad oder VSCode.
3. Füge folgenden Block hinzu (Passe die Werte an deine Umgebung an):
    
    ```ssh
    Host gitlab
        HostName gitlab.example.com
        Port 2022
        User git
        IdentityFile ~/.ssh/id_rsa
    
    ```
    
    
    - **Host**: ist der Alias, den du später im `ssh`- oder `git`-Befehl verwenden kannst (z. B. `gitlab`).
    - **HostName**: ist der tatsächliche Hostname oder die IP-Adresse deines GitLab-Servers.
    - **Port**: der Port, auf dem der SSH-Server läuft (hier 2022).
    - **User**: der Benutzername für den Login (bei GitLab i.d.R. `git`).
    - **IdentityFile**: optional, gibt den privaten SSH-Schlüssel an, falls du nicht den Standardpfad verwendest.
4. Speichere die Datei.

### Beispiel-Verwendung:

Statt so:

```bash
ssh -p 2022 git@gitlab.example.com

```

einfach so:

```bash
ssh gitlab

```

Oder beim Klonen eines Repositories:

```bash
git clone git@gitlab:username/repo.git

```

### Tipp

Wenn dein SSH-Schlüssel einen anderen Namen hat (z. B. `id_gitlab_rsa`), gib ihn explizit bei `IdentityFile` an:

```ssh
IdentityFile ~/.ssh/id_gitlab_rsa

```

### Hinweis zu Pfadangaben unter Windows

`~` funktioniert normalerweise auch unter Windows, aber wenn du Probleme hast, ersetze `~` durch den vollständigen Pfad, z. B.:

```ssh
IdentityFile C:/Users/DeinBenutzername/.ssh/id_rsa

```

Möchtest du, dass ich ein konkretes Beispiel mit deinen Daten schreibe?