# SSH Connection (Windows Powershell)

## Generating and Linking the Key

To begin, you need to install OpenSSH on Windows. You can do this from [this link](https://github.com/PowerShell/Win32-OpenSSH/releases).

1. After installation, verify it by entering the following command in PowerShell:

```
ssh -V
```

You should see the OpenSSH version displayed:

<figure><img src="/files/ed0owi7S9mnrJdsKFCT6" alt=""><figcaption><p>OpenSSH version</p></figcaption></figure>

{% hint style="info" %}
If nothing happens when checking the version, you can run:

`Add-WindowsCapability -Online -Name OpenSSH.Client*`
{% endhint %}

2. Next, generate an SSH key by entering the following command:

```
ssh-keygen -t ed25519 -C "example.powershell@gmail.com"
```

This will generate an "ed25519" key with the comment "<example.powershell@gmail.com>" to identify it. You can specify a path for the keys by adding `-f` and a path, for example:

```
ssh-keygen -t ed25519 -f ~/.ssh/my_new_key
```

<figure><img src="/files/h91rNoEE2wSTVSeMjRZG" alt=""><figcaption><p>Generating a Key in Powershell</p></figcaption></figure>

After this, the key pair will be created in the specified directory. One file will contain the public key, and the other the private key.

<figure><img src="/files/SR0oMKFm9a0DRi8WEHtI" alt=""><figcaption><p>Generated keys (pair)</p></figcaption></figure>

3. Run the following command to retrieve the public SSH key:

```
Get-Content ~/.ssh/id_ed25519.pub
```

Copy the public key from the output.

4. Open the MikoPBX web interface and go to "**System" → "General Settings"**:

<figure><img src="/files/1vOPYFjUveMAmF2v1kqB" alt=""><figcaption><p>"General settings" section</p></figcaption></figure>

5. Navigate to the **SSH** section and paste the public key into the **"SSH Authorized Keys"** field in the following format:

```
KeyType KeyData
```

Click **"Save settings"**:

<figure><img src="/files/K2YTngNGIxpj3CIZTlyH" alt=""><figcaption><p>"SSH Authorized Keys" field</p></figcaption></figure>

## Connecting via SSH

To connect via SSH, run the following command in PowerShell:

```
ssh -i C:\Users\<Username>\.ssh\id_ed25519 root@mikopbxipadress
```

Replace the following based on your parameters:

* The path to your SSH key.
* The IP address of your MikoPBX instead of `mikopbxipadress`.

You will then be connected to the MikoPBX console via SSH:

<figure><img src="/files/cSEbWPKWSSGeu3ePTV0u" alt=""><figcaption><p>Successful connection!</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/english/faq/troubleshooting/connecting-to-a-pbx-using-ssh/powershell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.