Troubleshooting SSH.NET

If you encounter problems using the library, use this page as a reference on how to try find the source of the problem.

Please ensure you are using the latest release of SSH.NET. If you are already using the latest release, then download and compile the latest source code. Don't forget to update your project(s) reference(s).

#Table of Contents#

1. Template for submitting an issue report
2. How to narrow your problem down
3. Frequently experienced SSH.NET exceptions
4. System.Net.Socket exceptions
5. NET TraceSource and TraceListeners
6. SSH server assisted troubleshooting
7. Log files
8. Debugging mode
   1. Debug level
   1. Foreground process
9. Unsupported remote systems
10. Watchguard Firewall

#Template for submitting an issue report# Before you submit an issue report, please ensure you are using the latest release of SSH.NET. If you are already using the latest release, then download and compile the latest source dode. Don't forget to update your project(s) reference(s).

Additionally, try to narrow down the problem by creating a very simple example that reproduces the problem you have. This is an important step, because it will eliminate most issues relating from other code that might influence the behavior of SSH.NET.

Please use this template when submitting a new issue report. It will provide the necessary details for a more precise understanding of the problem you have.

Just copy everything between the 2 lines and paste them into the description of the issue.

---

Remote Server Information

Remote SSH Server version:
Remote Operating System distribution name and architecture (x32/x64):
What kind of access do you have?:
Does Putty/WinSCP work?:

Local Machine Information

Operating System (for Windows, run winver.exe):
.NET Framework versions installed (See C:\WINDOWS\Microsoft.Net\Framework):

Project information

What is your target framework and architecture (x32/x64)?:
Is your project multi-threaded/complex?:

Source Code

Sample Code:
Exceptions and Stack Trace/Call Stack: