Differences
This shows you the differences between the selected revisions of the page.
| installation 2016-02-16 | installation 2025-06-13 (current) | ||
| Line 2: | Line 2: | ||
| //This article contains detailed description of downloading and installing WinSCP. You may want to see [[guide_install|simplified guide]] to the process instead.// | //This article contains detailed description of downloading and installing WinSCP. You may want to see [[guide_install|simplified guide]] to the process instead.// | ||
| - | The most users will prefer installing WinSCP for an easy setup. | + | Most users will prefer installing WinSCP for an easy setup. |
| Though note that, if you prefer so, you can use WinSCP executable as a [[portable|portable application]] with its [[config|settings stored in an INI file]] and no installation required. This configuration is best for using WinSCP from a removable media. | Though note that, if you prefer so, you can use WinSCP executable as a [[portable|portable application]] with its [[config|settings stored in an INI file]] and no installation required. This configuration is best for using WinSCP from a removable media. | ||
| Line 8: | Line 8: | ||
| ===== [[download]] Obtaining WinSCP ===== | ===== [[download]] Obtaining WinSCP ===== | ||
| You can obtain WinSCP from the [[&download|WinSCP download page]]. You should save the installer to an easily accessible location such as your Microsoft Windows desktop or your //My Documents// folder. | You can obtain WinSCP from the [[&download|WinSCP download page]]. You should save the installer to an easily accessible location such as your Microsoft Windows desktop or your //My Documents// folder. | ||
| + | |||
| + | WinSCP is also available from [[microsoft_store|Microsoft Store]]. | ||
| + | |||
| + | µsoft_store_badge | ||
| + | |||
| + | For corporate administrators, WinSCP is also available in a form of [[#msi|MSI package]]. | ||
| ===== [[running]] Running the WinSCP Installation Program ===== | ===== [[running]] Running the WinSCP Installation Program ===== | ||
| - If you have WinSCP running, close it. The installer will not run if it finds any instance of WinSCP running. | - If you have WinSCP running, close it. The installer will not run if it finds any instance of WinSCP running. | ||
| - | - Open the installation program by double·clicking on its icon. | + | - Open the installation program by double-clicking on its icon. |
| - The [[ui_installer|WinSCP installer]] starts. Follow its instructions. | - The [[ui_installer|WinSCP installer]] starts. Follow its instructions. | ||
| ===== [[upgrade]] Upgrading WinSCP ===== | ===== [[upgrade]] Upgrading WinSCP ===== | ||
| - | To upgrade WinSCP, [[#download|download]] the newer version, and then install it. The installation will preserve your configuration, and -- if necessary -- upgrade it. | + | To upgrade WinSCP, [[#download|download]] the newer version, and then install it over your current version. The installation will preserve your configuration, and -- if necessary -- upgrade it.((The new WinSCP version will be installed in your language, unless this particular localization is abandoned for a long time. The installation package contains all the translations that are actively maintained at the time of its release. Otherwise you must [[languages#install|install the new translation]] manually, if available. Any translation from your previous WinSCP version will not work with the new version.)) |
| - | + | ||
| - | The new WinSCP version will be installed in your language, if this particular localization has already been completed. The [[installation|installation package]] contains all the translations that were complete at the time of its release. Otherwise you must [[languages#install|install the new translation]] manually, if available. Any translation from your previous WinSCP version will not work with the new version. | + | |
| When upgrading Portable executable, just replace the executable files with the new version. New version can always read configuration from the old version. | When upgrading Portable executable, just replace the executable files with the new version. New version can always read configuration from the old version. | ||
| - | To check for rare backward incompatible changes between versions, search [[history|version history]] for "Change:". When upgrading from a version more than a year old, do not forget to search also [[history_old|old version history]]. | + | You can check for [[incompatible_changes|rare backward incompatible changes]]. |
| ===== [[downgrade]] Downgrading WinSCP ===== | ===== [[downgrade]] Downgrading WinSCP ===== | ||
| Line 28: | Line 32: | ||
| Note that some of your configurations may be lost when downgrading. To make sure that you will be able to downgrade, you should backup your [[config|configuration]] before the upgrade. | Note that some of your configurations may be lost when downgrading. To make sure that you will be able to downgrade, you should backup your [[config|configuration]] before the upgrade. | ||
| - | ===== Removing / Uninstalling WinSCP ===== | + | ===== [[uninstalling]] Removing / Uninstalling WinSCP ===== |
| - | To remove WinSCP, go to //Control Panel > Programs > Uninstall a program//. &wincp &winvista &win7 &win8 | + | To remove WinSCP, go to //Control Panel > Programs > Uninstall a program//. &wincp &winvista &win7 &win8 This works for the classic installation only. [[microsoft_store|Microsoft Store installation]] cannot be removed this way. |
| - | On Windows 10, you can also use //Settings > Apps & features//. &win10 | + | On Windows 11 and Windows 10, you can also use //Settings > Apps > Apps & features//. &win10 &win11 This works for either type of installations. In case you [[microsoft_store#transitioning|have both installations]], to distinguish them, check the program name. The classic installation has a version number in its name (e.g. //"WinSCP &winscp_stable_version"//), while the Store installation does not (on the other hand, it shows the author name – //"Martin Prikryl"//, and has //Advanced options// link and //Move// command). |
| - | During the removal, WinSCP will ask if you want to remove [[ui_cleanup|WinSCP configuration and other data stored on your computer]]. | + | During the removal, the uninstaller of the classic installation will ask, if you want to remove [[ui_cleanup|WinSCP configuration and other data stored on your computer]]. When uninstalling the Store installation, its configuration is removed unconditionally (but not the configuration of any previous classic installation). |
| ===== [[automating]] Automating Installation and Uninstallation ===== | ===== [[automating]] Automating Installation and Uninstallation ===== | ||
| Line 39: | Line 43: | ||
| You can use following parameters to automate the installation: | You can use following parameters to automate the installation: | ||
| - | * ''/SILENT'' - Runs the installer without any prompts (with the exception of error messages, etc.). Default selections are used for destination folder, components, etc. | + | * ''/LANG=language'' -- Runs the installer using the specified language. For the ''language'', use the //Code// from [[this>../translations.php|translations page]]. |
| - | * ''/VERYSILENT'' - As ''/SILENT'', but without showing the progress window. | + | * ''/==SILENT=='' -- Runs the installer without any prompts (with the exception of installation mode selection and error messages). Default selections are used for destination folder, components, etc. To select the [[ui_installer#mode|installation mode]], use ''/ALLUSERS'' or ''/CURRENTUSER''. |
| - | * ''/NORESTART'' - Instructs installer not to reboot even if it's necessary. | + | * ''/VERYSILENT'' -- As ''/SILENT'', but without showing the progress window. |
| - | * ''/LOG=%%"filename"%%'' - Causes Setup to create a log file. | + | * ''/ALLUSERS'' -- Instructs installer to install in administrative [[ui_installer#mode|install mode]]. |
| - | * ''/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. | + | * ''/CURRENTUSER'' -- Instructs installer to install in non administrative install mode. |
| - | * ''/SAVEINF=%%"filename"%%'' - Instructs Setup to save installation settings to the specified file. | + | * ''/NORESTART'' -- Instructs installer not to reboot even if it's necessary. |
| + | * ''/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. | ||
| + | * ''/NOCLOSEAPPLICATIONS'' -- Prevents Setup from closing applications using files that need to be updated by Setup. | ||
| - | See full list of [[http://www.jrsoftware.org/ishelp/index.php?topic=setupcmdline|InnoSetup setup command line parameters]]. | + | See full list of [[https://jrsoftware.org/ishelp/index.php?topic=setupcmdline|Inno Setup setup command line parameters]]. |
| WinSCP uninstaller (''unins000.exe'' in WinSCP installation directory) has the same parameters as above (except for ''/LOADINF'' and ''/SAVEINF''). | WinSCP uninstaller (''unins000.exe'' in WinSCP installation directory) has the same parameters as above (except for ''/LOADINF'' and ''/SAVEINF''). | ||
| - | See full list of [[http://www.jrsoftware.org/ishelp/index.php?topic=uninstcmdline|InnoSetup uninstaller command line parameters]]. When running uninstaller silently, [[ui_cleanup|configuration and other data stored on your computer]] are not removed. | + | See full list of [[https://jrsoftware.org/ishelp/index.php?topic=uninstcmdline|Inno Setup uninstaller command line parameters]]. When running uninstaller silently, [[ui_cleanup|configuration and other data stored on your computer]] are not removed. |
| ===== Custom Distribution of WinSCP ===== | ===== Custom Distribution of WinSCP ===== | ||
| Line 57: | Line 65: | ||
| Learn how a system administrator can [[administration|restrict or enforce certain functionality]] of the application. | Learn how a system administrator can [[administration|restrict or enforce certain functionality]] of the application. | ||
| + | ===== [[verifying]] Verifying Integrity of Installer ===== | ||
| + | Optionally, as a security measure, you can verify an integrity of the WinSCP installer binary before installing. | ||
| + | |||
| + | In Windows File Explorer display //Properties// of the installer and verify a signature on the //Digital Signatures// tab. The installer should be signed by "Martin Prikryl". | ||
| + | |||
| + | * The EV certificate used to sign the latest installers is valid from 2022-11-24 to 2026-02-18 and has the following SHA-1 thumbprint (hash): ''0dee8f52d6b8d8c4b2c9573f4299fd97d707bab7''. | ||
| + | * The EV certificate used to sign the older installers is valid from 2020-02-10 to 2023-02-17 and has the following %%SHA-1%% thumbprint (hash): ''fb845245cfbb0ee97e76c775348caa31d74bec4c''. | ||
| + | |||
| + | &screenshotpict(certificate) | ||
| + | |||
| + | The certificate can also be displayed on the User Account Control prompt, when starting an [[ui_installer#mode|installation for all users]]. | ||
| + | |||
| + | You can also verify file integrity manually. Find ==checksums== of the installer binary in the release notes or on the [[this>../../download/WinSCP-&winscp_stable_version-Setup.exe/download|installer download page]]. You can cross-check the checksum against a [[https://sourceforge.net/projects/winscp/files/WinSCP/&winscp_stable_version/|copy of the release notes on the SourceForge server]]. Use the ''[[https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/certutil|certutil]]'' tool to calculate a SHA-256 checksum of the downloaded installer and compare it. | ||
| + | |||
| + | <code> | ||
| + | C:\...>certutil -hashfile WinSCP-&winscp_stable_version-Setup.exe SHA256 | ||
| + | SHA256 hash of WinSCP-&winscp_stable_version-Setup.exe: | ||
| + | &winscp_stable_setup_sha256 | ||
| + | CertUtil: -hashfile command completed successfully. | ||
| + | </code> | ||
| + | |||
| + | ===== [[msi]] MSI Installer ===== | ||
| + | |||
| + | For corporate administrators, WinSCP is also available in a form of [[&downloads#stable_msi|MSI installer]]. | ||
| + | |||
| + | The installer has no configuration options. It installs complete WinSCP, including all translations, tools and extensions. | ||