Integration with PuTTY

To import sites from PuTTY go to Tools > Import Sites on Login dialog.

If WinSCP’s limited ability to execute remote commands does not meet your needs, you can let WinSCP open a shell session in a PuTTY client.

To open current session also in PuTTY, go to Commands > Open in PuTTY.

You can also set up WinSCP to Automatically open new sessions in PuTTY.

To open session in PuTTY, instead of WinSCP, use Manage > Open in PuTTY command on Login dialog.

By default, WinSCP creates temporary site settings for PuTTY (under the name “WinSCP temporary session”). The site settings will contain only the options known by WinSCP, mostly connection options. It will particularly lack any terminal options, so the defaults (Default Settings profile) will apply.

If you want to configure your own options, you can save PuTTY site settings with the same name as a WinSCP site. WinSCP will then instruct PuTTY to open that session (It will not export any settings, nor a connection options).

If WinSCP cannot find the PuTTY executable in the default path (particularly when you are using derived version of PuTTY) you can specify the path in preferences. Optionally you can also instruct WinSCP to send a session password (if known) to PuTTY. However a better approach would be to use public key authentication together with Pageant.

WinSCP registers to handle ssh:// URL and opens the session specified by the URL in PuTTY.

This feature is available only in the latest beta release.

If you want PuTTY to open in the same directory as WinSCP, you need to replace its session startup command using -m argument. The syntax of the session startup command would differ with a remote environment, particularly with an operating system and a shell.

For example with an Unix-like system and a bash shell, the command will be like (note the !/ pattern to pass the current remote path):

cd "!/" ; /bin/bash -login

As PuTTY needs the session startup command to be stored in a file, you need to make use of !`command` pattern to store the above command into a temporary file. Also as use of the -m switch implies a non-interactive terminal, you need to force an interactive terminal back using a -t switch.

A complete PuTTY command line for this will be like (change the shell path according to your system and preferences):

%PROGRAMFILES%\PuTTY\putty.exe -t -m "%TEMP%\putty.txt" !`cmd.exe /c echo cd "!/" ; /bin/bash -login > "%TEMP%\putty.txt"`

For your convenience you can download PuTTY also from our download page.

If you want to use KiTTY, instead of PuTTY, you need to configure path to KiTTY executable in preferences.

When using KiTTY in registry (non-portable) mode, you also need to specify KiTTY registry key in preferences.

When using KiTTY in portable mode, you need to specify patterns !U@!@ -P !# in terminal client path as an alternative way to pass hostname, username and port number to KiTTY. You may also use -title "!N" to pass a session name. The !# and !N are available in the latest beta version only.

kitty.exe !U@!@ -P !# -title "!N"

To open KiTTY in the same directory as WinSCP, you can use either the same technique as with PuTTY; or use KiTTY’s -cmd switch to avoid use of temporary file:

kitty.exe -cmd "cd ""!/"""

If you want to use Cygwin/OpenSSH, instead of PuTTY, you need to configure path to Cygwin/OpenSSH executable in preferences. You also need you to specify pattern !U@!@ in arguments to pass hostname and username1:

<path_to_cygwin>\bin\mintty.exe /bin/ssh !U@!@

where <path_to_cygwin> is by default C:\cygwin (32-bit) or C:\cygwin64 (64-bit).