# anonftp: Anonymous FTP Access

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