The ftpsubaccount.exe utility is designed to manage additional FTP accounts. The utility allows the following operations:

  • creating/deleting additional FTP accounts on subscriptions
  • changing additional FTP account login credentials, hard disk quota, home directory, and user permissions

Location

%plesk_cli%

Usage 

ftpsubaccount.exe <command> [<login_name>] [
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
]

Example

The following command creates an additional FTP account for the user JohnDoe on the subscription example.com, sets password userpass for the user, sets the hard disk quota for the additional FTP account to 50 MB, specifies the /httpdocs/ directory as the default home directory for the additional FTP account, and sets the Read permission for the user.

plesk bin ftpsubaccount.exe --create JohnDoe -domain example.com -passwd userpass -quota 50 -access_read true

Commands

Command Parameter Description Example
--create or -c <login>

Creates the additional FTP account.

Requires -domain and -passwd options.

To create an additional FTP account with login name JohnDoe and password userpass on the subscription example.com:

plesk bin ftpsubaccount.exe --create JohnDoe -passwd userpass -domain example.com

--update or -u <login> Updates a configuration of the existing additional FTP account with data specified in the options.

To change the password of additional FTP account for user with the login name JohnDoe to newpass:

plesk bin ftpsubaccount.exe --update JohnDoe -passwd newpass

or

plesk bin ftpsubaccount.exe -u JohnDoe -passwd newpass

--remove or -r <login> Deletes an additional FTP account for a user with a specified login name.

To delete the additional FTP account for the user with the login name JohnDoe:

plesk bin ftpsubaccount.exe --remove JohnDoe

or

plesk bin ftpsubaccount.exe -r JohnDoe

--info or -i <login> Displays information about a specified additional FTP account.

To view information about the additional FTP account for user with the login name JohnDoe:

plesk bin ftpsubaccount.exe --info JohnDoe

or

plesk bin ftpsubaccount.exe -i JohnDoe

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

To view help on the use of this utility:

plesk bin ftpsubaccount.exe --help

or

plesk bin ftpsubaccount.exe -h

Options

Option Parameter Description Example
-login <login> Sets a login name for a user of an additional FTP account.

To change the login name of the additional FTP account user from JohnDoe to John:

plesk bin ftpsubaccount.exe -u JohnDoe -login John

-passwd <password> Sets a password for an additional FTP account.

To change the password of the additional FTP account user JohnDoe to newpassword:

plesk bin ftpsubaccount.exe -u JohnDoe -passwd newpassword

-domain <domain name>

Specifies a subscription on which an additional FTP account is to be created.

Required with --create.

To create the additional FTP account with the login name JohnDoe and password userpass on the subscription example.com:

plesk bin ftpsubaccount.exe --create JohnDoe -passwd userpass -domain example.com

-quota <number> [B|K|M|G|T]

Limits the amount of available disk space for an additional FTP account.

Unlimited if set to 0 or a negative number.

To restrict the hard disk quota for the additional FTP account user JohnDoe to 50 megabytes:

plesk bin ftpsubaccount.exe -u JohnDoe -quota 50M

To set the hard disk quota for the additional FTP account user JohnDoe to unlimited:

plesk bin ftpsubaccount.exe -u JohnDoe -quota 0

or

plesk bin ftpsubaccount.exe -u JohnDoe -quota -1

-home <home_path>

Sets a path to the home directory for an additional FTP account.

Is /httpdocs by default.

To set the home directory for the additional FTP account user JohnDoe to the existing directory /httpdocs:

plesk bin ftpsubaccount.exe -u JohnDoe -home /httpdocs

The path is defined relative to the domain home directory path. The specified directory must exist.
-access_read true|false

Allows or prohibits viewing the content of the home directory and download files from it.

Is false by default.

To give read permission for the additional FTP account user JohnDoe:

plesk bin ftpsubaccount.exe -u JohnDoe -access_read true

-access_write true|false

Allows or prohibits creating, viewing, renaming, and deleting directories in the home directory.

Is false by default.

To give write permission for the additional FTP account user JohnDoe:

plesk bin ftpsubaccount.exe -u JohnDoe -access_read true