This is an old revision of the document!
Installation
The WinSCP application can be used as a self contained application with its settings stored in an INI file and no installation required. This configuration is most suitable for using WinSCP from removable media. A full installation is recommended where practical.
- Obtaining WinSCP
- Running the WinSCP Installation Program
- Automating Installation
- Upgrading/Downgrading WinSCP
- Uninstalling WinSCP
Advertisement
Obtaining WinSCP
You can obtain WinSCP directly from the WinSCP download page. There are two packages available, English-only and multilanguage package. You may wish to save the installer to an easily accessed location such as the desktop or your My Documents folder.
Running the WinSCP Installation Program
- If you have WinSCP running, close it. Installer will not run if it finds any instance of WinSCP running.
- Open the installation program by double clicking on its icon.
- If you have downloaded Multilanguage installation package, you will have chance to select language for the installation. Your selection will affect also which language will be selected by default for installation. You can change this on Select Components screen.
- A Welcome Screen should appear. Click Next in order to continue.
- The License Agreement should appear. Review the license carefully, select the option I accept the agreement, and click Next to continue.
- You will be prompted for a Destination. Normally the default provided will be acceptable. Change the Destination Folder if you desire, and then click next to proceed.
- After selecting the Destination Folder, the Component Selection screen should appear. Its recommended that you choose a full installation, however, if you do not intend to use some of the optional components, or already have them installed, you may select another option here. Advanced users may want to learn more about purpose of the drag&drop shell extension. When you are satisfied with your selection, click Next to proceed.
- After selecting components, you will be prompted for a Start Menu Folder. You may change this from the default of WinSCP3, leave it as is, or click the Don’t Create a Start Menu Folder check box. When you are satisfied with your selection click Next to proceed.
- After selecting a Start Menu Folder, you will be prompted for Additional Installation Tasks. These tasks define how WinSCP integrates itself to Windows. Review the options carefully. If you are unsure, the options may be safely left at their defaults. Note that if you are installing on a computer with multiple users, you may wish to select the For all users radio button under Create a Desktop Icon in order to make WinSCP readily accessible to other users. After making your selections, click next to continue.
- After the Additional Installation Tasks screen, you’ll be prompted to choose which interface to use. This can be easily changed later. If you are using WinSCP for the first time, you may wish to select the Explorer-like interface, as it should be familiar to any Windows user. You may first learn more about the WinSCP user interfaces. Once you have made your choice, click next.
- Once you choose the interface to use, you’ll arrive at the Ready to Install screen. On this screen, you can review a list of all selected installation options. If you wish to change anything, you may press the back button until you return to the appropriate screen. If everything appears to be in order, click Install and the actual installation process will start.
- A brief installation process will take place. If certain options such as drag-and-drop integration were selected, you may be prompted to restart the computer. If necessary, choose whether or not to restart and then click finish. If you choose not to restart, some functionality of WinSCP may not be available until you do so.
Automating Installation
WinSCP uses Inno Setup as installer. It allows automation of the installation procedure using optional command-line parameters.
Advertisement
To automate the installation you can use following parameters:
/SILENT
- Runs installer without any prompts (with exception of error messages, etc.). Default selections are used for destination folder, components, etc./VERYSILENT
- As/SILENT
, but without showing the progress window./LOG=“filename”
- Causes Setup to create a log file./LOADINF=“filename”
- Instructs Setup to load the settings from the specified file after having checked the command line. This file can be prepared using the/SAVEINF
parameter./SAVEINF=“filename”
- Instructs Setup to save installation settings to the specified file.
For full list of parameters refer to Inno Setup help.
Upgrading/Downgrading WinSCP
To upgrade WinSCP to newer version, just install the newer version over the existing installation. Your configuration will be preserved (and upgraded when necessary).
Note that the translation from older version of WinSCP will not work with the newer one. You need to install new translation too.
In general you may downgrade in a same way too, but some configuration may be lost. To make sure that you will be able downgrade, you should backup your configuration before upgrade.
Uninstalling WinSCP
To uninstall WinSCP use Add/Remove Programs function of Windows (Start > Settings > Control Panel > Add/Remove Programs). During uninstallation you will be asked if you want to remove WinSCP configuration and other data stored on your computer.