address
-------

:Default value: Empty
:Optional: No
:Values: * Host name or IP address of the FTP server.
:From version: 3.13.0
:Description:
    Address of the server. IP or host name.

    In order to check the identity of the remote server the address should
    be provided as FQDN.
    IP addresses are not supported by the server identity validation process.


port
----

:Default value: `21` or `990 (for implicit FTPS)`
:Optional: Yes
:Values: * Number, greater than 0.
:From version: 3.13.0
:Description:
    Port number to connect to the server.


username
--------

:Default value: Empty
:Optional: No
:From version: 3.13.0
:Values: * Text.
:Description:
    Username used to authenticate to the server.


password
--------

:Default value: Empty
:Optional: Yes
:From version: 3.13.0
:Values: * Plain text password.
         * Empty.
:Description:
    This option specifies the password used to connect to the server.

    It is defined in plain text format.

    For `FTP` it is sent over the network in plain text without any transport protection.

    For `FTPS` (explicit or implicit) it is sent over the network protected by the TLS protocol.


acct
----

:Default value: `empty`
:Optional: Yes
:Values: * text
:From version: 4.28.0
:Description:
    Extra account value sent via the `ACCT` command if requested by the FTP server.

    Most FTP servers don't need the extra account (ACCT) information.
    This is empty by default.

    The location will fail to authenticate if this is empty and extra ACCT information is required.


debug
-----

:Default value: `No``
:Optional: Yes
:Values: * `Yes`
         * `No`
:From version: 4.0.0
:Description:
    When enabled, the location will emit events with id `20000`,
    containing low-level debug messages for the file transfer protocol.

    ..  warning::
        When this is enabled, emitted events may include used password
        in plain text.


ignore_passive_address
----------------------

:Default value: `Yes`
:Optional: Yes
:Values: * `Yes`
         * `No`
:From version: 4.27.0
:Description:
    When enabled, the IP address returned by the `PASV` command is ignored.
    The same address as the one used for the command channel is used instead.
