Differences
This shows you the differences between the selected revisions of the page.
| requirements 2013-04-05 | requirements 2024-05-16 (current) | ||
| Line 2: | Line 2: | ||
| ===== Server Requirements ===== | ===== Server Requirements ===== | ||
| - | Using WinSCP, you can connect to an [[SSH]] (Secure Shell) server with [[SFTP]] (SSH File Transfer Protocol) or [[SCP]] (Secure Copy Protocol) service or to an [[FTP]] (File Transfer Protocol) server. | + | Using WinSCP, you can connect to an [[SSH]] (Secure Shell) server with [[SFTP]] (SSH File Transfer Protocol) or [[SCP]] (Secure Copy Protocol) service, to an [[FTP]] (File Transfer Protocol) server, HTTP server with WebDAV service or store system with [[S3]] protocol support. |
| - | SFTP is a standard part of the SSH-2 package. SCP is a standard part of the SSH-1 package. You can also run both protocols on the latter SSH version. WinSCP supports both SSH-1 and SSH-2. For authentication, you can use user name and password or [[public key]] (RSA or DSA). Other authorization types include TIS, Cryptocard, Keyboard-interactive, and Kerberos. | + | SFTP is a standard file transfer protocol supported by most SSH servers. SCP is legacy protocol, supported mostly by OpenSSH and some other servers. For authentication, you can use user name and password or [[public key]]. Other authorization types include Keyboard-interactive, and Kerberos. |
| For FTP, both the basic unencrypted variant and [[ftps|FTPS]] are supported. Compressed transfers (Zlib) are not supported. | For FTP, both the basic unencrypted variant and [[ftps|FTPS]] are supported. Compressed transfers (Zlib) are not supported. | ||
| + | |||
| + | For WebDAV, both the basic unencrypted variant and WebDAVS are supported. Compressed transfers (Zlib) are not supported. | ||
| ===== [[sftp]] SFTP Requirements ===== | ===== [[sftp]] SFTP Requirements ===== | ||
| - | For SFTP, the only requirement beyond the server requirements above is to run SFTP on the server. It is best to run it as an SSH-2 subsystem. If you select SFTP-only on the login screen and the SFTP subsystem is not found, WinSCP will try to find the SFTP server in some common directories (''/usr/lib/sftp-server'', ''/usr/local/lib/sftp-server'', etc.). This way, it is possible to use SFTP even with SSH-1, which does not support subsystems. | + | For SFTP, the only requirement beyond the server requirements above is to run SFTP on the server. Most SSH servers include SFTP server. |
| ===== [[scp]] SCP Requirements ===== | ===== [[scp]] SCP Requirements ===== | ||
| - | As the SCP protocol implements file transfers only, WinSCP must use other means to implement the additional functionality (like directory listing). WinSCP uses Unix-like shell commands to do that. This in turn means that when using the SCP protocol, it can connect to servers that run Unix-like or its emulation only ((e.g. Cygwin on Windows. See [[faq_openssh_win|FAQ]] to learn how to use WinSCP with a Windows server running OpenSSH on Cygwin.)). | + | As the SCP protocol implements file transfers only, WinSCP must use other means to implement the additional functionality (like directory listing). WinSCP uses Unix-like shell commands to do that. This in turn means that when using the SCP protocol, it can connect to servers that run Unix-like or its emulation only. |
| - | To transfer files, ''scp1'' is used (it is called from within ''scp''). If only ''scp2'' is allowed on your server, check the //[[ui_login_scp#other_options|Use scp2 with scp1 compatibility]]// option on the [[ui_login_scp|SCP/Shell tab]] in the Login dialog. | + | To transfer files, ''scp1'' is used (it is called from within ''scp''). If only ''scp2'' is allowed on your server, check the //[[ui_login_scp#other_options|Use scp2 with scp1 compatibility]]// option on the //[[ui_login_scp|SCP/Shell page]]// on the Advanced Site Settings dialog. |
| For correct functionality, you must do the following. The ''bash'' shell is recommended for working with WinSCP. If your default shell doesn't work with WinSCP, you can make WinSCP use [[ui_login_scp#shell|other shell]]. | For correct functionality, you must do the following. The ''bash'' shell is recommended for working with WinSCP. If your default shell doesn't work with WinSCP, you can make WinSCP use [[ui_login_scp#shell|other shell]]. | ||
| Line 24: | Line 26: | ||
| Another precondition is that the output of all commands be in English. This mostly concerns names of months in directory listings (''ls -la''). Because of this, WinSCP [[ui_login_scp#other_options|clears all user variables that govern command output]] after login. If command output also reflects some other server settings, it may be necessary to change this before WinSCP can be used. | Another precondition is that the output of all commands be in English. This mostly concerns names of months in directory listings (''ls -la''). Because of this, WinSCP [[ui_login_scp#other_options|clears all user variables that govern command output]] after login. If command output also reflects some other server settings, it may be necessary to change this before WinSCP can be used. | ||
| - | The last necessary condition is the proper output of the ''ls -la'' command, particularly the standard number and ordering of the columns. If the default output does not satisfy the needs of WinSCP you can use //[[ui_login_scp#directory_listing|Listing command]]// option on the //SCP/Shell tab// in the Login dialog to modify it. | + | The last necessary condition is the proper output of the ''ls -la'' command, particularly the standard number and ordering of the columns. If the default output does not satisfy the needs of WinSCP you can use //[[ui_login_scp#directory_listing|Listing command]]// option on the //SCP/Shell page// on the Advanced Site Settings dialog to modify it. |
| WinSCP will attempt detect support for the ''%%--full-time%%'' switch of the ''ls'' command. If the detection causes you problems, you can [[ui_login_scp#directory_listing|disable]] it. | WinSCP will attempt detect support for the ''%%--full-time%%'' switch of the ''ls'' command. If the detection causes you problems, you can [[ui_login_scp#directory_listing|disable]] it. | ||
| - | ===== Using WinSCP with Restricted Shell Environments ===== | + | ===== [[restricted_shell]] Using WinSCP with Restricted Shell Environments ===== |
| A number of restricted shell environments exist for supporting | A number of restricted shell environments exist for supporting | ||
| - | SFTP/SCP only accounts. These systems restrict the user to a small | + | SFTP/SCP only accounts. These systems restrict an user to a small |
| - | subset of commands needed to manipulate files while denying the | + | subset of commands needed to manipulate files, while denying an |
| ability to execute arbitrary commands. Some of these environments | ability to execute arbitrary commands. Some of these environments | ||
| - | create incompatibilities with WinSCP, particularly if using SCP. | + | create incompatibilities with WinSCP, particularly if using %%SCP%%. |
| ===== [[remote_environment]] Effect of Remote User Environment on WinSCP Sessions ===== | ===== [[remote_environment]] Effect of Remote User Environment on WinSCP Sessions ===== | ||
| Line 46: | Line 48: | ||
| ===== [[client]] Client Requirements ===== | ===== [[client]] Client Requirements ===== | ||
| - | WinSCP runs on Microsoft Windows 2000 and newer, up to Windows 8/Windows Server 2012. It runs both on client and server editions of Microsoft Windows. We know of no reason why WinSCP should not continue to work on future versions of Microsoft Windows. | + | WinSCP runs on Microsoft Windows XP SP2/Windows Server 2003 SP1 and newer, up to Windows 11 and Windows Server 2022. WinSCP runs both on client and server editions of Microsoft Windows. We know of no reason why WinSCP should not continue to work on future versions of Microsoft Windows. |
| + | |||
| + | The application //installer// does not run on Windows 7 without SP1/2008 R2 without SP1 and older. If you need to use WinSCP on an older version of Windows, use //Portable executables// download. | ||
| While there is 32-bit version of WinSCP available only, it runs on 64-bit editions of Microsoft Windows. | While there is 32-bit version of WinSCP available only, it runs on 64-bit editions of Microsoft Windows. | ||
| - | WinSCP also runs on [[http://www.winehq.org/|Wine]]. See [[http://appdb.winehq.org/objectManager.php?sClass=application&iId=1285|WinSCP entry on Wine AppDB]]. | + | On Windows Server, WinSCP runs both in "Server with Desktop Experience" ("Server with a GUI") and "Server Core" installation options. |
| + | |||
| + | WinSCP also runs on [[https://www.winehq.org/|Wine]]. See [[https://appdb.winehq.org/objectManager.php?sClass=application&iId=1285|WinSCP entry on Wine AppDB]]. | ||
| + | |||
| + | WinSCP requires 40–100 MB of free disk space. | ||
| - | WinSCP requires at most 15 MiB of free disk space. | + | We take care to make WinSCP an ==accessible== application, particularly to visually impaired people. WinSCP can be used on systems with screen readers. |