The anonftp utility is used to manage anonymous FTP access on domains with physical hosting on a Plesk server. By using this utility, you can perform the following tasks:

  • enabling/disabling the anonymous FTP access on a domain
  • restricting download bandwidth and the maximum number of simultaneous FTP connections
  • managing the incoming directory properties
  • configuring welcome message displayed upon anonymous FTP user login

Usage

anonftp <command> <domain_name> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command enables the anonymous FTP service on the domain example.com and enables displaying the login message with the text “Welcome to FTP service” upon the anonymous FTP user login .

plesk bin anonftp --update example.com -status true -message true -message-text "Welcome to FTP service"

Commands

Command Parameter Description Example
--update or -u <domain_name> Updates the anonymous FTP settings on a specified domain.

To enable downloading files from the incoming directory by users on the domain example.com:

plesk bin anonftp --update example.com -status true -incoming-downloads true

or

plesk bin anonftp -u example.com -status true -incoming-downloads true

--info or -i <domain_name> Displays information about the anonymous FTP settings on a specified domain.

To view information about anonymous FTP settings on the domain example.com:

plesk bin anonftp --info example.com

or

plesk bin anonftp -i example.com

--help or -h   Displays help on the use of the utility.

To view help on the use of the anonftp utility:

plesk bin anonftp --help

or

plesk bin anonftp -h

Options

Option Parameter Description Example
-status true|false Enables/Disables the anonymous FTP service on a domain.

To enable the anonymous FTP service on the domain example.com:

plesk bin anonftp -u example.com -status true

-message true|false Enables/Disables displaying a login message upon anonymous FTP user login.

To enable displaying a login message upon the anonymous FTP user login on the domain example.com:

plesk bin anonftp -u example.com -message true

-message-text <string> Specifies a login message text.

To display the ‘Welcome to FTP service’ login message when logging to the anonymous FTP service on the domain example.com:

plesk bin anonftp -u example.com -status true -message true -message-text "Welcome to FTP service"

-incoming true|false

Enables/Disables uploading to the incoming directory.

Is false by default.

To enable uploading files to the incoming directory on the domain example.com:

plesk bin anonftp -u example.com -status true -incoming true

-incoming-dirs true|false Allows/Prohibit creating directories in the incoming directory.

To allow creating directories in the incoming directory on the domain example.com:

plesk bin anonftp -u example.com -status true -incoming-dirs true

-incoming-downloads true|false

Enables/Disables downloading from the incoming directory.

Is false by default.

To enable downloading files from the incoming directory on the domain example.com:

plesk bin anonftp -u example.com -status true -incoming-downloads true

-incoming-limit <number>[K|M|G]

Limits the disk space used by the incoming directory.

Unlimited if set to -1.

A number without a letter is interpreted as the number of bytes.

To restrict the disk space for the incoming directory on the domain example.com to 10 MB:

plesk bin anonftp -u example.com -status true -incoming-limit 10M

-max-connects <number>

Limits the number of available simultaneous FTP connections.

Unlimited if set to -1.

To restrict the maximum number of simultaneous FTP connections to 40:

plesk bin anonftp -u example.com -status true -max-connects 40

-bandwidth <number>[K|M|G]

Restricts the download bandwidth.

Unlimited if set to -1.

A number without a letter is interpreted as the number of bytes.

To restrict the download bandwidth to 500 KB:

plesk bin anonftp -u example.com -status true -bandwidth 500K