Differences
This shows you the differences between the selected revisions of the page.
| installation 2019-07-07 | 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. | ||
| - | nigga edsrfhert herth eheh erh | + | ===== [[upgrade]] Upgrading WinSCP ===== |
| + | 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.)) | ||
| + | |||
| + | When upgrading Portable executable, just replace the executable files with the new version. New version can always read configuration from the old version. | ||
| + | |||
| + | You can check for [[incompatible_changes|rare backward incompatible changes]]. | ||
| ===== [[downgrade]] Downgrading WinSCP ===== | ===== [[downgrade]] Downgrading WinSCP ===== | ||
| Line 26: | 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 37: | 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 error messages, etc.). Default selections are used for destination folder, components, etc. | + | * ''/==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]]. | ||
| + | * ''/CURRENTUSER'' -- Instructs installer to install in non administrative install mode. | ||
| * ''/NORESTART'' -- Instructs installer not to reboot even if it's necessary. | * ''/NORESTART'' -- Instructs installer not to reboot even if it's necessary. | ||
| * ''/LOG=%%"filename"%%'' -- Causes Setup to create a log file. | * ''/LOG=%%"filename"%%'' -- Causes Setup to create a log file. | ||
| Line 45: | 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 61: | 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 certificate used to sign the latest installers has an SHA-1 hash ''0b 3d 1c 21 77 3b 6f d7 8f bf 41 8a 5e a2 d9 1c 0e 51 44 d3'' and is valid from 2016-11-17 to 2020-01-23. | + | * 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 old installers has an %%SHA-1%% hash ''4a 14 66 81 58 d7 9d f2 ac 08 a5 ee 77 58 8e 5c 6a 6d 2c 8f'' and was valid from 2016-01-03 to 2016-10-23. | + | * 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) | ||
| - | The certificate can also be displayed on the //[[ui_installer#uac|User Account Control]]// prompt, when starting the installer. | + | 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> | ||
| C:\...>certutil -hashfile WinSCP-&winscp_stable_version-Setup.exe SHA256 | C:\...>certutil -hashfile WinSCP-&winscp_stable_version-Setup.exe SHA256 | ||
| - | SHA256 hash of file WinSCP-&winscp_stable_version-Setup.exe: | + | SHA256 hash of WinSCP-&winscp_stable_version-Setup.exe: |
| &winscp_stable_setup_sha256 | &winscp_stable_setup_sha256 | ||
| CertUtil: -hashfile command completed successfully. | CertUtil: -hashfile command completed successfully. | ||
| </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. | ||