Troubleshooting

General Hints

When facing an issue with WinSCP, following resources and hints may help you to resolve the issue yourself:

  • Try to find solution in F.A.Q or in this documentation. Use Search box on the right,
  • If you are getting an error message, check list of common error messages.
  • Try to find a solution in support forum. Again, use Search box on the right, this time check Whole site.
  • Make sure you are using the latest version of WinSCP.
  • If some feature of WinSCP is not working as you expect, check documentation of respective dialog box (use Help button). You may be missing configuration option or may not understand what the feature actually does.
  • If you wonder why some feature of WinSCP is or not available (is disabled/grayed), check documentation of respective dialog box (use Help button).
Advertisements:

Troubleshooting Connection Issues

When you are not able to connect to the server:

  • Make sure you use protocol that the server supports.
  • Read guide for connecting to FTP/SFTP server.
  • Try if you can connect with other client using the same protocol.
  • Check other F.A.Q. on connection.
  • If you are getting an error message, check list of common error messages.
  • If the server refuses to accept your connection or drops the connection suddenly, you should better check the server (e.g. its log file) first to find out the reason. Contact the server administrator if you cannot check the server yourself.

Troubleshooting Scripting/Automation Issues

When you are facing issue with scripting/automation:

Troubleshooting Timestamp Issues

When the file timestamps you see in file panels are not what you expect them to be; or synchronization does not work:

When inspecting the session log, look for following entries:

  • Directory listing, including UTC file modification timestamps:
..;D;0;2013-04-24T08:43:23.000Z;"" [0];"" [0];rw-rw-rw-;1                                
.htaccess;-;33;2004-11-10T20:46:46.000Z;"" [0];"" [0];rw-rw-rw-;3                        
commandline.txt;-;9390;2013-04-15T09:01:52.000Z;"" [0];"" [0];rw-rw-rw-;1                
config.txt;-;4490;2013-04-17T06:31:36.000Z;"" [0];"" [0];rw-rw-rw-;1                     
contributions.txt;-;1865;2012-08-24T07:08:58.000Z;"" [0];"" [0];rw-rw-rw-;1              
directory_cache.txt;-;1892;2011-07-30T18:24:52.000Z;"" [0];"" [0];rw-rw-rw-;1            
dragext.txt;-;4329;2013-04-09T11:50:48.000Z;"" [0];"" [0];rw-rw-rw-;1                    
  • Modification timestamp being set on target file after file transfer (SFTP):
Preserving timestamp [2009-02-26T21:15:50.000Z]
  • Timestamp comparing during synchronization:
Local file 'D:\Documents\wiki\config.txt' [2013-04-24T09:41:04.922Z] [4546] is modified 
comparing to remote file '/home/martinp/httpdocs/wiki/config.txt' [2013-04-17T06:31:36.000Z] [4490]

If this does not help you, and you decide to seek support, make sure you include complete session log in your report, showing above entries.

When you are not able to help yourself

Learn what support you may get to WinSCP.

1) For FTP this is specifically mandated for MLSD command. With obsoleted LIST command, behaviour is undefined.
 
  troubleshooting.txt · Last modified: by prikryl
 

Search Documentation

This page

Donate

About donations

$9   $19   $49   $99

About donations

Recommend

Associations

Site design by Black Gate