Raw Configuration

You can use raw configuration to setup rare advanced global settings.

In scripting and with command-line operations, use /rawconfig parameter (when the settings cannot be configured using dedicated command-line parameter or scripting command).

In .NET assembly, use Session.AddRawConfiguration method (when the settings cannot be configured using any dedicated property of Session class).

Advertisement

In GUI, for those low-level settings that do not have an equivalent GUI control, also use the /rawconfig parameter, when starting the GUI. You need to do this once once, the setting will be preserved.

See also raw site settings and raw transfer settings.

Common Advanced Settings

Name Description Values
Interface\ExternalIpAddress External IP address
Interface\LocalPortNumberMin
Interface\LocalPortNumberMax
FTP active mode listening ports limits
Interface\SessionReopenAuto Delay of automatic reconnect of session that breaks during transfer. In milliseconds. 0 = disable automatic reconnect
Interface\SessionReopenAutoStall Automatically reconnect session, if it stalls 0 = do not reconnect, else a number of milliseconds before reconnect.
Interface\KeepUpToDateChangeDelay Upload delay after change is detected while Keeping remote directory up to date In milliseconds.
Interface\MimeTypes MIME type (Content type) overrides. Comma separated list of overrides with syntax mask=mime_type, where mask is a file mask.
Example: *.js=application/javascript,*.png=image/png
Interface\QueueTransferLimitMax Limit of Maximal number of transfers at the same time Defaults to 9.
Interface\LocalIconsByExt Turn off loading icons from local files off = Load icons from local files, on = Resolve icons for local files by file extension only
Interface\HonorDrivePolicy Follow Windows File Explorer configuration for hiding drives off = Show all drives, on = Hide hidden drives
Interface\TimeoutShellOperations Run potentially lengthy shell operations on background thread (can cause instability) off, on
Interface\LocaleSafe Language Decimal LCID of the language/locale. E.g. 1033 for English (United States)
Interface\BeepSound A path to a sound file or system sound alias for the Beep when work finishes function. Defaults to system sound alias SystemDefault.
Interface\FlashTaskbar Flash taskbar button when user interaction is needed off, on
Interface\MinimizeToTray Minimize main window to taskbar status area. off, on
Interface\DDDisableMove Disable moving remote files when dropping them to another application off, on
Interface\SessionTabNameFormat Format of session tab title 0 = Only session name, 1 = Distinguish multiple sessions opened to the same site by the name of the current folder, 2 = As 1, but truncate long paths
Interface\TryFtpWhenSshFails When SFTP connection is rejected, knock FTP port off, on
Interface\SynchronizeOptions Options for Keep Remote Directory up to Date Bitmask. 1 = Update subdirectories, 2 = Synchronize on start, 4 = Ask user whether to Synchronize on start, 8 = Continue on error
The 4 and 8 has an effect with /keepuptodate command-line operation only.
Interface\SynchronizeParams Options for Synchronization and Keep Remote Directory up to Date Bitmask. 1 = Delete files (with /keepuptodate and /synchronize command-line operations only, in scripting use the -delete switch, in .NET assembly use the removeFiles argument of the Session.SynchronizeDirectories), 4 = Existing files only, 64 = Preview changes (with /synchronize command-line operation only, in scripting use the -preview switch, in .NET assembly use Session.CompareDirectories method), 256 = Synchronize timestamps mode, 512 = Turn off Modification time comparison criteria (with /synchronize command-line operation only, in scripting use the -criteria switch, in .NET assembly use the criteria argument of the Session.SynchronizeDirectories), 1024 = File size comparison criteria (with /synchronize command-line operation only, see 512), 4096 = Mirror mode (with /synchronize command-line operations only, in scripting use the -mirror switch, in .NET assembly use the mirror argument of the Session.SynchronizeDirectories), 8192 = Case sensitive comparison criteria, 16384 = Checksum comparison criteria (with /synchronize command-line operation only, see 512)
Interface\MaxWatchDirectories Keep Remote Directory up to Date directory count warning limit
Interface\ScriptProgressFileNameLimit Maximal length of a filename in scripting progress output Defaults to 25.
Logging\LogFileAppend Append session log file off, on
Logging\LogProtocol Log level -12 (Reduced, Normal, Debug 1 and Debug 2 logging levels respectively)
In the scripting, use a command-line switch /loglevel.
Logging\LogSensitive Log passwords and other sensitive information off, on
In the scripting, use a command-line switch /loglevel=*.
Logging\LogMaxSize Rotate log files after reaching In bytes.
In the scripting, use a command-line switch /logsize.
Logging\LogMaxCount Delete old logs files, keep … files In the scripting, use a command-line switch /logsize.

Advertisement

Other Settings

To find correct syntax for settings not listed above, configure the setting in the GUI, save configuration to an INI file and use the same syntax as you find an INI file.

The settings is identified using syntax section\name, where the section is a path to configuration section from [Configuration] section in an INI file.1 E.g. to configure a setting ExternalIpAddress in section [Configuration\Interface], use Interface\ExternalIpAddress.

Example

For example to configure an External IP address, in scripting:

winscp.com /rawconfig Interface\ExternalIpAddress=198.51.100.10 /script=...

or in .NET assembly (using PowerShell):

$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")

In WinSCP GUI, to enable an option (which is not configurable directly in the GUI), it’s usually enough to run WinSCP GUI once like this:

winscp.exe /rawconfig Interface\HonorDrivePolicy=off
  1. Or HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\Configuration key in a registry.Back

Last modified: by martin