subscription_settings.exe: Hosting Subscription Settings
The subscription_settings.exe
utility is used for managing settings
related to subscriptions and hosting services.
Location
%plesk_cli%
Usage
subscription_settings.exe <command> [<domain name>] [
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
]
Example
The following command sets the following settings for the subscription example.com: the available disk space to 1 GB, and the maximum number of MySQL databases to 4.
plesk bin subscription_settings.exe --update example.com -disk_space 1G -max_db 4
Commands
Command | Parameter | Description | Example |
---|---|---|---|
--update or -u
|
<domain_name> |
Updates subscription settings. |
To restrict the amount of disk space available for the subscription example.com to 1 GB: plesk bin subscription_settings.exe --update example.com -disk_space 1G or plesk bin subscription_settings.exe -u example.com -disk_space 1G |
--info or -i
|
<domain_name> |
Displays information about subscription settings. |
To view information about settings of the subscription example.com: plesk bin subscription_settings.exe --info example.com or plesk bin subscription_settings.exe -i example.com |
--set-default or -d
|
<domain_name> |
For subscriptions that are assigned shared IP addresses, this option sets the default domain/subscription. |
To set the domain example.com as the default domain for the IP address to which it is assigned: plesk bin subscription_settings.exe --set-default example.com or subscription_settings.exe -d example.com |
--update-php-settings |
<domain_name> |
Updates custom PHP configuration for a subscription. This configuration will override the one from the service plan and will act as a preset for all websites in the subscription. Use the utility to set values for 16 most often used PHP settings (exposed to Plesk GUI) or to add any additional PHP directive. |
To set one of 16 general PHP settings, prepare the file with the settings you want to change. Note: File syntax should be the same with Then apply the settings to the subscription example.com: plesk bin subscription_settings.exe --update-php-settings example.com -settings my_file If you cannot find a certain PHP parameter among 16 general settings, add it as an additional directive to a file and apply the changes to the subscription: plesk bin subscription_settings.exe --update-php-settings example.com -additional-settings my_file_add |
--show-php-settings |
<domain_name> |
Displays information about current PHP configuration of a subscription. |
To view the PHP configuration information for the subscription example.com: plesk bin subscription_settings.exe --show-php-settings example.com |
--help or -h
|
Displays help on the use of the utility. |
To view help on the use of the plesk bin subscription_settings.exe --help or subscription_settings.exe -h |
Options
Option | Parameter | Description | Example |
---|---|---|---|
-disk_space |
<number>[B|K|M|G|T] |
Limits the amount of available disk space. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To restrict the amount of disk space available for subscription example.com to 10 GB: plesk bin subscription_settings.exe -u example.com -disk_space 10G |
-disk_space_soft |
<number>[B|K|M|G|T] |
Sets the amount of disk space upon reaching which notification is sent. |
To set up sending of an e-mail notification upon occupying 5 gigabytes of disk space under the subscription example.com: plesk bin subscription_settings.exe -u example.com -disk_space_soft 5G |
-max_traffic |
<number>[B|K|M|G|T] |
Limits the monthly traffic usage. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To restrict the maximum amount of traffic available for the subscription example.com to 10 GB/month: plesk bin subscription_settings.exe -u example.com -max_traffic 10G |
-max-traffic-soft |
<number>[B|K|M|G|T] |
Sets the amount of monthly traffic upon reaching which notification is sent. |
To set the amount of traffic upon reaching which notification is sent for the subscription example.com to 5 GB/month: plesk bin subscription_settings.exe -u example.com -max_traffic_soft 5G |
-max_box |
<number> |
Limits the number of available mailboxes. Unlimited if set to |
To restrict the maximum number of mailboxes available for the subscription example.com to 50: plesk bin subscription_settings.exe -u example.com -max_box 50 |
-mbox_quota |
<number>[B|K|M|G|T] |
Limits the amount of disk space that a single mailbox can occupy. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To set the mailbox quota for the subscription example.com to 100 MB: plesk bin subscription_settings.exe -u example.com -mbox_quota 100M |
-total_mboxes_quota |
<number>[B|K|M|G|T] |
Limits the total domain mail quota to the specified size. Unlimited if set to |
To set the total mailbox quota for the subscription example.com to 2 00 MB: plesk bin subscription_settings.exe -u example.com -total_mbox_quota 200M |
-max_wu |
<number> |
Limits the number of available web users. Unlimited if set to |
To restrict the maximum number of web users available for the subscription example.com to 50: plesk bin subscription_settings.exe -u example.com -max_wu 50 |
-max_mysql_db |
<number> |
Limits the number of available MySQL databases. Unlimited if set to |
To set the number of MySQL databases available for the subscription example.com to unlimited: plesk bin subscription_settings.exe -u example.com -max_mysql_db -1 |
-max_mssql_db |
<number> |
Limits the number of available MSSQL databases. Unlimited if set to |
To set the number of MSSQL databases available for the subscription example.com to unlimited: plesk bin subscription_settings.exe -u example.com -max_mssql_db -1 |
-mysql_dbase_space |
<number>[B|K|M|G|T] |
Restricts the maximum amount of disk space allotted to MySQL databases. Unlimited if set to |
To restrict the disk space occupied by all MySQL databases of example.com to 500 MB: plesk bin subscription_settings.exe -u example.com -mysql_dbase_space 500 |
-mssql_dbase_space |
<number>[B|K|M|G|T] |
Restricts the maximum amount of disk space allotted to Microsoft SQL Server databases. Unlimited if set to |
To restrict the disk space occupied by Microsoft SQL Server databases of example.com to 700 MB: plesk bin subscription_settings.exe -u example.com -mssql_dbase_space 700 |
-mssql_dbase_filesize |
<number>[B|K|M|G|T] |
Limits the file size of a Microsoft SQL Server database to the specified value. Unlimited if set to |
To restrict the file size of Microsoft SQL Server databases of example.com to 1000 MB: plesk bin subscription_settings.exe -u example.com -mssql_dbase_filesize 1000M |
-mssql_dbase_log_filesize |
<number>[B|K|M|G|T] |
Limits the log file size of a Microsoft SQL Server database to the specified value. Unlimited if set to |
To restrict the log file size of Microsoft SQL Server databases of example.com to 5000 MB: plesk bin subscription_settings.exe -u example.com -mssql_dbase_filesize 5000M |
-max_maillists |
<number> |
Limits the number of available mailing lists. Unlimited if set to |
To restrict the maximum number of mailing lists available for the subscription example.com to 3: plesk bin subscription_settings.exe -u example.com -max_maillists 3 |
-max_webapps |
<number> |
Limits the number of available Java applications. Unlimited if set to |
To restrict the maximum number of Java applications available for the subscription example.com to 10: plesk bin subscription_settings.exe -u example.com -max_webapps 10 |
-max_subdom |
<number> |
Limits the number of available subdomains. Unlimited if set to |
To restrict the maximum number of subdomains available for the subscription example.com to 15: plesk bin subscription_settings.exe -u example.com -max_subdom 15 |
-max_odbc_dsn |
<number> |
Limits the number of available ODBC DSN connections. Unlimited if set to |
To set the number of ODBC connections available for the subscription example.com to 5: plesk bin subscription_settings.exe -u example.com -max_odbc_dsn 5 |
-expiration |
<YYYY-MM-DD> |
Limits the validity period for a subscription. Unlimited if set to |
To set the validity period for the subscription example.com to 2010-11-30: plesk bin subscription_settings.exe -u example.com -expiration 2010-11-30 |
-www |
true|false |
Enables or disables the www prefix. Is |
To disable the www prefix for domains hosted under the subscription example.com: plesk bin subscription_settings.exe -u example.com -www false |
-wuscripts |
true|false |
Enables or disables scripting support for web users. Is |
To enable scripting support for web users for the subscription example.com: plesk bin subscription_settings.exe -u example.com -wuscripts true |
-webmail |
mewebmail|horde|none |
Switches webmail on or off for a subscription. |
To switch off webmail support for the subscription example.com: plesk bin subscription_settings.exe -u example.com -webmail none |
-no_usr |
bounce:<txt>|<email>|<IP>|reject|discard |
Sets the mode of automatic action toward mail messages addressed to non-existent users. Is |
To have messages addressed to non-existent users bounced back with text No such mailbox on the server for the subscription example.com: plesk bin subscription_settings.exe -u example.com -no_usr bounce:"No such mailbox on the server" To have messages addressed to non-existent users forwarded to mail address admin@example.com for the subscription example.com: plesk bin subscription_settings.exe -u example.com -no_usr admin@example.com |
-max_dom_aliases |
<number> |
Limits the number of available domain aliases. Unlimited if set to |
To set the maximum number of domain aliases available for the subscription example.com to 10: plesk bin subscription_settings.exe -u example.com -max_dom_aliases 10 |
-max_subftp_users |
<number> |
Limits the maximum number of additional FTP accounts. Unlimited if set to |
To allow 100 additional FTP accounts for the subscription example.com: plesk bin subscription_settings.exe -u example.com -max_subftp_users 100 |
-max_db |
<number> |
Limits the number of available databases. Unlimited if set to |
To set the number of databases available for the subscription example.com to unlimited: plesk bin subscription_settings.exe -u example.com -max_db -1 |
-overuse |
block|not_suspend|notify|normal|not_suspend_notify |
Sets the resource overuse policy:
|
To set the resource overuse policy to plesk bin subscription_settings.exe -u example.com -overuse notify |
-keep_traf_stat |
<number> |
Defines the number of months during which the system keeps traffic usage statistics. Keeping statistics during unlimited period if set to |
To make the system retain traffic statistics for example.com during 5 months: plesk bin subscription_settings.exe -u example.com -keep_traf_stat 5 |
-max_site |
<number> |
Specifies the number of websites that can be hosted under a subscription. |
To set the number of websites that can be hosted under subscription example.com to 10: plesk bin subscription_settings.exe -u example.com -max_site 10 |
-max_site_builder |
<number> |
Specifies the number of websites that can be created and published with Presence Builder. |
To set the number of websites that can be created and published with Presence Builder under subscription example.com to 10: plesk bin subscription_settings.exe -u example.com -max_site_builder 10 |
-sign_outgoing_mail |
true|false |
Allows or prohibits using the DKIM spam protection method. Is |
To use DKIM spam protection for the subscription example.com: plesk bin subscription_settings.exe -u example.com -sign_outgoing_mail true |
-outgoing_messages_domain_limit |
<number>|default |
Sets the maximum number of outgoing messages from a domain (per hour). To set the Unlimited value, specify “-1”. Specify “default” to set the value specified in server-wide settings. |
To set the limit on outgoing email messages from a domain: plesk bin subscription_settings.exe -u example.com -outgoing_messages_domain_limit 12 |
-outgoing_messages_subscription_limit |
<number>|default |
Sets the maximum number of outgoing messages from a subscription (per hour). To set the Unlimited value, specify “-1”. Specify “default” to set the value specified in server-wide settings. |
To set the limit on outgoing email messages from a subscription: plesk bin subscription_settings.exe -u example.com -outgoing_messages_subscription-limit 110 |
-create_domains |
true|false |
Allows or prohibits creating domains. Is |
To allow the owner of the subscription example.com to create domains: plesk bin subscription_settings.exe -u example.com -create_domains true |
-manage_phosting |
true|false |
Allows or prohibits managing web hosting settings. Is |
To allow the owner of the subscription example.com to manage web hosting settings: plesk bin subscription_settings.exe -u example.com -manage_phosting true |
-manage_php_settings |
true|false |
Allows/Prohibits managing common PHP settings. |
To allow the owner of the subscription example.com to manage common PHP settings: plesk bin subscription_settings.exe -u example.com -manage_php_settings true |
-manage_php_version |
true|false |
Allows/Prohibits choosing the PHP version. |
To allow the owner of the subscription example.com to choose the PHP version: plesk bin subscription_settings.exe -u example.com -manage_php_version true |
-manage_performance |
true|false |
Allows or prohibits managing hosting performance settings. |
To allow the owner of the subscription example.com to manage hosting performance settings: plesk bin subscription_settings.exe -u example.com -manage_performance true |
-manage_sh_access |
true|false |
Allows or prohibits managing access to the system through Remote Desktop. |
To allow the owner of the subscription example.com to manage access and to connect to the server: plesk bin subscription_settings.exe -u example.com -manage_sh_access true |
-manage_quota |
true|false |
Allows or prohibits changing the amount of allocated disk space. |
To allow the owner of the subscription example.com to manage the hard quota on allocated disk space: plesk bin subscription_settings.exe -u example.com -manage_quota true |
-manage_subdomains |
true|false |
Allows or prohibits managing subdomains. |
To allow the owner of the subscription example.com to manage subdomains: plesk bin subscription_settings.exe -u example.com -manage_subdomains true |
-manage_domain_aliases |
true|false |
Allows or prohibits managing domain aliases. |
To allow the owner of the subscription example.com to manage domain aliases: plesk bin subscription_settings.exe -u example.com -manage_domain_aliases true |
-manage_log |
true|false |
Allows or prohibits managing log rotation, namely, to adjust the cleanup and recycling of processed log files. |
To allow the owner of the subscription example.com to adjust log recycling settings: plesk bin subscription_settings.exe -u example.com -manage_log true |
-manage_anonftp |
true|false |
Allows or prohibits managing Anonymous FTP. A website should reside on a dedicated IP address in order to use anonymous FTP service. Is |
To allow the owner of the subscription example.com to set up anonymous FTP share: plesk bin subscription_settings.exe -u example.com -manage_anonftp true |
-manage_subftp |
true|false |
Allows or prohibits managing additional FTP accounts. |
To allow the owner of the subscription example.com to set up additional FTP accounts: plesk bin subscription_settings.exe -u example.com -manage_subftp true |
-manage_crontab |
true|false |
Allows or prohibits scheduling tasks on the server. |
To allow the owner of the subscription example.com to schedule tasks on the server: plesk bin subscription_settings.exe -u example.com -manage_crontab true |
-manage_dns |
true|false |
Allows or prohibits managing DNS settings for websites. Is |
To allow the owner of the subscription example.com to manage DNS zones: plesk bin subscription_settings.exe -u example.com -manage_dns true |
-manage_webapps |
true|false |
Allows or prohibits installing and managing Java web applications. |
To allow the owner of the subscription example.com to install and manage Java applications: plesk bin subscription_settings.exe -u example.com -manage_webapps true |
-manage_mail_settings |
true|false |
Allows/Prohibits adjusting mail settings. |
To allow the administrator adjusting mail settings: plesk bin subscription_settings.exe -u example.com -manage_mail_settings true |
-manage_maillists |
true|false |
Allows or prohibits managing mailing lists. |
To allow the owner of the subscription example.com to set up mailing lists: plesk bin subscription_settings.exe -u example.com -manage_maillists true |
-manage_spamfilter |
true|false |
Allows or prohibits configuring spam filter on the mail account level (if the correspondent option is enabled in the server-wide configuration). |
To allow the owner of the subscription example.com to configure spam filter: plesk bin subscription_settings.exe -u example.com -manage_spamfilter true |
-manage_virusfilter |
true|false |
Allows or prohibits managing antivirus protection settings. |
To allow the owner of the subscription example.com to manage antivirus settings: plesk bin subscription_settings.exe -u example.com -manage_virusfilter true |
-manage_iis_app_pool |
true|false |
Allows or prohibits managing IIS application pool. |
To allow the owner of the subscription example.com to manage IIS application pool: plesk bin subscription_settings.exe -u example.com -manage_iis_app_pool true |
-manage_webstat |
true|false |
Allows or prohibits selecting the web statistics program to use for websites. |
To allow the owner of the subscription example.com to select web statistics program: plesk bin subscription_settings.exe -u example.com -manage_webstat true |
-manage_additional_permissions |
true|false |
Allows or prohibits managing additional write and modify permissions. If it is May be required for web applications correct functioning, but is insecure. |
To allow the owner of the subscription example.com to manage additional write/modify permissions: plesk bin subscription_settings.exe -u example.com -manage_additional_permissions true |
-select_db_server |
true|false |
Allows or prohibits choosing DB server from the servers registered in Plesk, when creating a database. |
To allow the owner of the subscription example.com to select a database server during creation of a new database: plesk bin subscription_settings.exe -u example.com -select_db_server true |
-remote_db_connection |
true|false |
Allows or prohibits setting up custom access settings for database users under a subscription. |
To allow the owner of the subscription example.com to set up remote or local access to their databases: plesk bin subscription_settings.exe -u example.com -remote_db_connection true |
-manage_website_maintenance |
true|false |
Allows/Prohibits performing website maintenance. |
To allow the owner of the subscription example.com to perform website maintenance: plesk bin subscription_settings.exe -u example.com -manage_website_maintenance true |
-manage_protected_dirs |
true|false |
Allows/Prohibits managing password-protected directories. |
To allow the owner of the subscription example.com to manage password-protected directories: plesk bin subscription_settings.exe -u example.com -manage_protected_dirs true |
-access_service_users |
true|false |
Allows/Prohibits managing additional user accounts. |
To allow the owner of the subscription example.com to manage additional user accounts: plesk bin subscription_settings.exe -u example.com -access_service_users true |
-allow_local_backups |
true|false |
Allows or prohibits backing up and restoring websites, and keeping backup files on the hosting server. |
To allow the owner of the subscription example.com to back up and restore websites, and keep the data on the server: plesk bin subscription_settings.exe -u example.com -allow_local_backups true |
-allow_ftp_backups |
true|false |
Allows or prohibits backing up and restoring websites, and saving them to custom FTP servers. |
To allow the owner of the subscription example.com to back up and restore websites, and keep the data on custom FTP servers: plesk bin subscription_settings.exe -u example.com -allow_ftp_backups true |
-allow_account_local_backups |
true|false |
Allows or prohibits backing up and restoring the account, and keeping backup files on the hosting server. |
To allow the owner of the subscription example.com to back up and restore their account, and keep the data on the server: plesk bin subscription_settings.exe -u example.com -allow_account_local_backups true |
-allow_account_ftp_backups |
true|false |
Allows or prohibits backing up and restoring the account, and saving them to custom FTP servers. |
To allow the owner of the subscription example.com to back up and restore their account, and keep the data on custom FTP servers: plesk bin subscription_settings.exe -u example.com -allow_account_ftp_backups true |
-access_appcatalog |
true|false |
Allows or prohibits access to applications catalog for viewing and installing prepackaged applications on sites. |
To allow the owner of the subscription example.com to access applications catalog and install applications on websites: plesk bin subscription_settings.exe -u example.com -access_appcatalog true |
-allow_insecure_sites |
true|false |
Allows or prohibits overriding server-wide security policy on web hosting scripting options, if the policy is set up. |
To allow the owner of the subscription example.com to override security policy: plesk bin subscription_settings.exe -u example.com -allow_insecure_sites true |
-allow_license_stubs |
true|false |
If your Plesk license comes in a bundle with APS app licenses,
you can install such apps without the need to purchase the app
licenses from vendors. By setting the -allow_license_stubs
option to true , you grant your customer the same
permission: They can install apps from the bundle to their
websites without purchasing app licenses. Note that you cannot
limit the number of app installations a customer is allowed to
perform. Thus, a customer can install a commercial app an
unlimited number of times. |
To allow the owner of the subscritpion example.com to install APS apps using licenses from the license bundle: plesk bin subscription_settings.exe -u example.com -allow_license_stubs |
-settings |
<filename> |
Sets the file containing custom PHP settings for a subscription. The file can include only 16 general PHP settings exposed to the Plesk GUI. Used with |
To set custom PHP configuration from the file my_file to the subscritpion example.com: plesk bin subscription_settings.exe --update-php-settings example.com -settings my_file |
-additional-settings |
<filename> |
Sets the file containing custom PHP settings for a subscription. The file can include any PHP directive except 16 general PHP settings exposed to the Plesk GUI. Used with |
To add directives to custom PHP configuration from the file my_file_add (example.com): plesk bin subscription_settings.exe --update-php-settings example.com -additional-settings my_file_add |
-outgoing-messages-domain-limit |
<number>|default |
Sets the maximum number of outgoing messages from a domain (per hour). To set the Unlimited value, specify “-1”. Specify “default” to set the value specified in server-wide settings. |
To set the default value for the limit on outgoing email messages from a domain of the subscription example.com: plesk bin subscription_settings.exe -u example.com -outgoing-messages-domain-limit 10 |
-outgoing-messages-subscription-limit |
<number>|default |
Sets the maximum number of outgoing messages from a subscription (per hour) that Plesk will use by default in subscriptions created under the specified service plan. To set the Unlimited value, specify “-1”. Specify “default” to set the value specified in server-wide settings. |
To set the default value for the limit on outgoing email messages from a subscription example.com:: plesk bin subscription_settings.exe -u example.com -outgoing-messages-subscription-limit 50 |
-default_server_mssql |
<host:port>|none |
Sets the default Microsoft SQL Server. Websites within the plan’s subscriptions will use it for storing SQL Server databases. The |
To set the default database server of Microsoft SQL Server type for the subscription example.com: plesk bin subscription_settings.exe -u example.com -default_server_mssql localhost:0 |
-default_server_mysql |
<host:port>|none |
Sets the default MySQL database server. Websites within the plan’s subscriptions will use it for storing MySQL databases. The |
To set the default database server of MySQL type for the subscription example.com: plesk bin subscription_settings.exe -u example.com -default_server_mysql 123.123.123.123:3306 |
-ext_permission_git_manage_git |
true|false |
Allows Git management. Requires the Git Manager extension installed. |
To allow Git management to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_git_manage_git true |
-ext_permission_nodejs_support_management |
true|false |
Allows Node.js management. Requires the Node.js Manager extension installed. |
To allow Node.js management to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_nodejs_support_management true |
-ext_permission_nodejs_state_management |
true|false |
Allows Node.js state management. Requires the Node.js Manager extension installed. |
To allow Node.js state management to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_nodejs_state_management true |
-ext_permission_nodejs_version_management |
true|false |
Allows Node.js version management. Requires the Node.js Manager extension installed. |
To allow Node.js version management to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_nodejs_version_management true |
-ext_permission_wp_toolkit_manage_wordpress_toolkit |
true|false |
Gives access to the WordPress Toolkit extension. |
To give access to WordPress Toolkit to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_wp_toolkit_manage_wordpress_toolkit true |
-ext_permission_wp_toolkit_manage_security_wordpress_toolkit |
true|false |
Gives access to security management in the WordPress Toolkit extension. |
To give access to WordPress Toolkit to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_wp_toolkit_manage_security_wordpress_toolkit true |
-webmail-certificate |
<string> |
Secures the webmail service with a specified SSL/TLS certificate. |
To secure the webmail service on the subscription example.com with the certificate Cert1: plesk bin subscription_settings.exe --update example.com -webmail_certificate "Cert1" |
-ext_permission_wp_toolkit_manage_cloning
|
true|false |
Allows cloning of WordPress installations in the WordPress Toolkit extension. |
To allow cloning of WordPress installations to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_wp_toolkit_manage_cloning true |
-ext_permission_wp_toolkit_manage_syncing |
true|false |
Allows synchronization of WordPress installations in the WordPress Toolkit extension. |
To allow synchronization of WordPress installations to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_wp_toolkit_manage_syncing true |
-ext_permission_wp_toolkit_manage_autoupdates |
true|false |
Allows management of auto-updates in the WordPress Toolkit extension. |
To allow auto-updates management in WordPress Toolkit to the owner of the example.com subscription: plesk bin subscription_settings.exe -u example.com -ext_permission_wp_toolkit_manage_autoupdates true |