[[TOC()]]

= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / FTP =

== FTP Connect Mode ==

Choose between an [http://en.wikipedia.org/wiki/File_Transfer_Protocol#Connection_methods active or passive connection] per [wiki:help/en/howto/bookmarks bookmark] or when opening a [wiki:help/en/howto/connection#Toolbarbutton new connection]. The default setting can be set in the ''System Preferences'' in ''Network'' → ''Advanced...'' → ''Proxies'' → ''Use Passive FTP Mode (PASV)''.

== Character Encoding ==

The character encoding used to parse directory listings can be set as a per bookmark setting. See [wiki:help/en/problems#SpecialcharacterssuchasUmlautearentdisplayedcorrectlyinthebrowser problems].

== TLS Connections (FTPS) ==

Only [http://en.wikipedia.org/wiki/FTPS#Explicit explicit] TLS is supported.

=== Disable SSL/TLS X.509 certificate trust validation ===

If you have problems with the ''Keychain'' trust settings, you can use the following options to disable verification of certificates. Be aware that this a severely compromising security. This is '''not''' a recommended configuration. Before disabling trust verification, try to restart Cyberduck after editing the trust setting.
 * Disable certificate validation for ''FTP-TLS'':

{{{
defaults write ch.sudo.cyberduck ftp.tls.acceptAnyCertificate true
}}}

== Server compatibility ==

=== ProFTPd ===
 * You need to have the option set `TLSOptions NoSessionReuseRequired` for FTP-TLS connections. Issue #5087.
 * You need to have the option set `TLSOptions AllowClientRenegotiations` for FTP-TLS connections. Issue #3012.


== Problems ==

=== It is not possible to change permissions. The error message {{{FTP Error: SITE not understood}}} or similar is displayed ===
The server does not support this feature (which is an optional extension to the FTP protocol) and can not be used.

=== Make file listing parsers whitespace aware (FTP) ===

~~To make the parsers for directory listings aware of whitespace in filenames (leading or trailing), enter~~. This is already set by default.

{{{
defaults write ch.sudo.cyberduck ftp.parser.whitespaceAware true
}}}

To revert the behaviour, set this property to `false` if you have issues with filenames parsed with a leading whitespace as described in #2895.

=== Listing directories fails or shows no content (FTP) ===
Directory listings are requested using {{{STAT}}}, {{{LIST -a}}} and {{{LIST}}} commands in that order. If a failure is detected (because the server may not support the command), the next option is tried. Because this can be fuzzy logic, it may still be that Cyberduck does not correctly fall back to a supported list command. You may then try to force the use of a given command. 

To disable {{{STAT}}} for directory listings, open a Terminal.app window and enter

{{{
defaults write ch.sudo.cyberduck ftp.sendStatListCommand false
}}}

To disable {{{LIST -a}}} for directory listings, open a Terminal.app window and enter

{{{
defaults write ch.sudo.cyberduck ftp.sendExtendedListCommand false
}}} 

To disable {{{MLSD}}} for directory listings, open a Terminal.app window and enter

{{{
defaults write ch.sudo.cyberduck ftp.sendMlsdListCommand false
}}} 

Restart Cyberduck.

== References ==

 * [http://en.wikipedia.org/wiki/FTPS FTPS Wikipedia Article]