This is an old revision of the document!

Configuration Storage

WinSCP can store its configuration both to Windows registry and INI file. When installed, the configuration is stored by default into the registry. Portable versions use by default an INI file (if possible). To switch the storage see Storage tab of Preferences window.

Note that configuration of restrictions and enforcements by administrator, is always stored in Windows registry.

Removing Configuration
Exporting/Backing up the Configuration
Importing/Restoring Configuration
Transferring the Configuration
Registry Key
INI File Location
Auto-selecting Storage
Checking What Store Is in Use
Portable Configuration
Pre-configuring WinSCP

Removing Configuration

You can clean up all configuration data stored on your machine.

Exporting/Backing up the Configuration

To export/back up your configuration, go to Tools > Export/Backup configuration on Sites/Stored Sessions tab of Login dialog (available only in the latest beta release). In versions prior to the latest beta release, use Export button on Preferences dialog.

Importing/Restoring Configuration

To import/restore the configuration, go to Tools > Import/Restore configuration on Sites/Stored Sessions tab of Login dialog (available only in the latest beta release). In versions prior to the latest beta release, copy the exported INI file into the directory that WinSCP is installed. If you do not have a write permissions to the installation directory, you can point WinSCP to a different location.

Transferring the Configuration

To transfer your configuration to another computer/location, export the configuration to an INI file and then import the file on the another computer/location.

Registry Key

If you use registry as configuration storage, the configuration is stored under following key.

[HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2]

INI File Location

When loading configuration, WinSCP first looks for an INI file in the directory, where WinSCP executable is stored in. The INI file needs to have an .ini extension and the same name as the executable. If INI file in not found there, WinSCP looks to application data directory of your user profile (This feature is available only in the latest beta release.).

When you opt to use INI file for the first time, WinSCP tries to write it to directory, where WinSCP executable is stored in. If the directory is not writable, INI file is stored to application data directory of your user profile (This feature is available only in the latest beta release.).

You may also use an INI file in a different folder or with a different name using /ini switch.

Particularly, when using shared INI file, or if you store the INI file to directory, where WinSCP does not have write access to, you can set read-only attribute to the INI file to prevent WinSCP from overwriting the file or failing, when writing to it.

Auto-selecting Storage

On startup, WinSCP is first looking for an INI file is located in the directory from which WinSCP was started1. If it does not find one, it looks for presence of its key in registry (The key is created by installer, so installed WinSCP uses registry by default). If it does not find that either, it creates an INI file in the default location.

Checking What Store Is in Use

When troubleshooting problems, it is necessary to find whether WinSCP is actually using the configuration storage you intended. For that inspect a beginning of the session log:

-------------------------------------------------------------------------- 
WinSCP Version 5.0.2 (Build 1456) (OS 5.1.2600 Service Pack 3)             
Configuration: HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\         
Local account: INTRANET\martin

Tag Configuration shows either HKEY_CURRENT_USER Windows registry key or a path to an INI file. When Windows registry configuation storage is in use, it is also important under what Windows account is WinSCP running, to know what account the HKEY_CURRENT_USER refers to. For that refer to Local account tag.