---
title: "Troubleshooting for Windows"
manual: "TYPO3 Core Contribution Guide"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3contribute:troubleshooting-for-windows"
source: "Appendix/Windows/Troubleshooting.rst"
rendered: "2026-09-26T04:50:59+00:00"
---

# Troubleshooting for Windows {#troubleshooting-for-windows}

> [!IMPORTANT]
> Its strongly recommended to use the Git Bash on Windows as shown in previous
> chapters. We experienced issues with powershell etc. and some commands
> described in the documentation only work in Git Bash.

## SSH {#ssh}

### Permission denied (publickey) {#permission-denied-publickey}

If you try to push to gerrit and you keep getting the following error message

```none
Permission denied (publickey).
fatal: Could not read from remote repository.
```

#### Checklist for SSH problems {#checklist-for-ssh-problems}

1.  Make sure the **public** SSH key is stored in your Gerrit account.

    See [Setting up Gerrit (ssh)](https://docs.typo3.org/permalink/t3contribute:gerritaccount)
1.  Check if your **private** SSH key is in the correct OpenSSH format.

    You can export your SSH key to the correct OpenSSH format with the Putty Key
    Generator with Conversions -> Export OpenSSH Key -> save with a filename,
    but without a file ending!
1.  Check if the ssh-agent is running or turn it on

    ```bash
    ssh-agent -s
    ```
1.  Add your SSH key to the ssh-agent

    ```bash
    ssh-add ~/.ssh/my_key
    ```

    The SSH key should have NO file ending (like .ppk).
    In windows explorer you should find the SSH key in
    the file:

    ```bash
    C:\Users\<username>\.ssh\
    ```