Skip to content

Troubleshooting Steps

Joey Aiello edited this page May 15, 2017 · 17 revisions

If sshd won't start:

  • Ensure that sshd_config is in the same directory as sshd.exe
  • Ensure that host keys are generated and have the correct file permissions:
    • Ensure that private host keys are secured
    • Ensure that NT service\sshd has Read access to public and private key files

Troubleshooting steps for typical connection issues:

  • Server side: run sshd in debug mode
    • net stop sshd
    • In an elevated Administrator console, run sshd in debug mode
      • sshd.exe -d
    • This will dump debug logs in real time to stdout on the console
    • You can also add additional ds to get more debug information:
      • sshd.exe -dd or sshd.exe -ddd
  • Client side: start ssh in verbose mode
    • ssh.exe -v ...
    • This will dump verbose logs in real time to stdout on the console
    • You can also add additional vs to get more verbose messages:
      • ssh.exe -vv ... or ssh.exe -vvv

Troubleshooting more complex issues:

  • Server side
    • Stop sshd and ssh-agent services
      • Get-Service ssh* | Stop-Service
    • Delete sshd.log and ssh-agent.log (in the logs directory of your installation path)
    • Set LogLevel to DEBUG (or DEBUG2/DEBUG3 for higher levels of logging) in sshd_config
    • Rerun the workflow that's giving you problems. logs\sshd.log and logs\ssh-agent.log will contain sshd and ssh-agent related traces respectively.
    • If the problem isn't clear, please post these logs along with some steps to help us reproduce your problem in our GitHub Issues.
  • Client side
    • Set LogLevel to DEBUG (or DEBUG2/DEBUG3 for higher levels of logging) in ssh_config.
    • Run ssh.exe in verbose mode as detailed above
Clone this wiki locally