Configuring WinSCP As a Custom Launcher

This topic is configuration only—see Creating Custom Launchers for instructions.

Custom Process Launcher

General Settings

  • Wrap custom parameters with quotation marks: No

  • Record Multiple Windows: Yes

  • Record Additional Processes: < None >

  • Use SSH Tunneling with SSH Proxy: No

Windows Settings

  • Process Name: winscp.exe

  • Process Argument: scp://$username:$password@$machine:$port

  • Process Argument: sftp://$username:$password@$machine:$port

  • Run Process As Secret Credentials: No

  • Load User Profile: No

  • Use Operating System Shell: No

Process Arguments:
  • WinSCP provides different protocols. The settings above show SCP or SFTP.
  • $machine is used because it is a direct connection.

Custom Process Tunneled Launcher

General Settings

  • Wrap custom parameters with quotation marks: No

  • Record Multiple Windows: Yes

  • Record Additional Processes: < None >

  • Use SSH Tunneling with SSH Proxy: Yes

Windows Settings

  • Process Name: winscp.exe

  • Process Argument: scp://$username:$password@$host:$port

  • Process Argument: sftp://$username:$password@$host:$port

  • Run Process As Secret Credentials: No

  • Load User Profile: No

  • Use Operating System Shell: No

Process Arguments:
  • WinSCP provides different protocols. The settings above show SCP or SFTP.
  • $host is used because it is a tunneled connection.

Custom Process Proxied Launcher

General Settings

  • Wrap custom parameters with quotation marks: No

  • Record Multiple Windows: Yes

  • Record Additional Processes: < None >

  • Use SSH Tunneling with SSH Proxy: Yes

Windows Settings

  • Process Name: winscp.exe

  • Process Argument: scp://$username:$password@$host:$port /rawsettings Shell=/bin/bash

  • Process Argument: sftp://$username:$password@$host:$port /rawsettings SftpServer=/usr/libexec/openssh/sftp-server

  • Run Process As Secret Credentials: No

  • Use Operating System Shell: No

Process Arguments:
  • WinSCP provides different protocols. The settings above show SCP or SFTP.
  • $host is used because it is a proxied connection.

SCP

/rawsettings Shell=/bin/bash must be specified to state the Unix shell used.

The value will be different depending on each account, /bin/bash is common but the exact value is obtained from executing the following command

[jeff@box ~]$ echo $SHELL

/bin/bash

SFTP

/rawsettings SftpServer=/usr/libexec/openssh/sftp-server must be specified to instruct how to launch the FTP server. The value could be different depending on what is installed on the Unix server—best to run one of the following commands to determine the answer:

[root@box jeff]# ps -ef --forest

[root@box jeff]# ps -ef | grep ftp