Differences
This shows you the differences between the selected revisions of the page.
| installation 2020-02-25 | installation 2024-04-24 (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 12: | Line 12: | ||
| µsoft_store_badge | µ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, 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. | + | |
| 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. | ||
| Line 33: | Line 33: | ||
| ===== [[uninstalling]] 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 > System > 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 44: | Line 44: | ||
| You can use following parameters to automate the installation: | You can use following parameters to automate the installation: | ||
| * ''/LANG=language'' -- Runs the installer using the specified language. For the ''language'', use the //Code// from [[this>../translations.php|translations page]]. | * ''/LANG=language'' -- Runs the installer using the specified language. For the ''language'', use the //Code// from [[this>../translations.php|translations page]]. | ||
| - | * ''/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'' and ''/CURRENTUSER''. | + | * ''/==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''. |
| * ''/VERYSILENT'' -- As ''/SILENT'', but without showing the progress window. | * ''/VERYSILENT'' -- As ''/SILENT'', but without showing the progress window. | ||
| * ''/ALLUSERS'' -- Instructs installer to install in administrative [[ui_installer#mode|install mode]]. | * ''/ALLUSERS'' -- Instructs installer to install in administrative [[ui_installer#mode|install mode]]. | ||
| Line 54: | Line 54: | ||
| * ''/NOCLOSEAPPLICATIONS'' -- Prevents Setup from closing applications using files that need to be updated by Setup. | * ''/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|Inno Setup 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|Inno Setup 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 70: | Line 70: | ||
| 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". | 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 2020-02-10 to 2023-02-17 and has the following SHA-1 thumbprint (hash): ''fb845245cfbb0ee97e76c775348caa31d74bec4c'' | + | * 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 certificate that was used to sign older installers was valid from 2016-11-17 to 2020-01-23 and has the following SHA-1 thumbprint (hash): ''0b3d1c21773b6fd78fbf418a5ea2d91c0e5144d3'' | + | * 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) | &screenshotpict(certificate) | ||
| Line 77: | Line 77: | ||
| The certificate can also be displayed on the User Account Control prompt, when starting an [[ui_installer#mode|installation for all users]]. | 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|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://docs.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. | + | 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> | <code> | ||
| Line 86: | Line 86: | ||
| </code> | </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. | ||