This chapter describes the version-specific changes in the command-line utilities. The changes are grouped by new features. To describe a particular change in CLI, we use the following notations:

  • (+) - the specified utility, command, or option is added
  • (-) - the specified utility, command, or option is deprecated
  • (*) - the specified utility, command, or option is modified

Plesk Onyx

Server Configuration

  • (*) init_conf utility:
    New option: -trial_license. Available starting with Plesk 17.8.10.

    Deprecated options: -default-ip, -netmask, -iface, -ip-type, -admin_info_not_required.

Apache & nginx settings for websites

  • (*) subscription utility:

    New options: -web-server-expires, -web-server-expires-static-only, -web-server-headers, -nginx-cache-enabled, -nginx-cache-size, -nginx-cache-timeout, -nginx-cache-key, -nginx-cache-cookies, -nginx-cache-bypass-locations, -nginx-cache-bypass-header-nocache, -nginx-cache-bypass-header-auth, -nginx-cache-bypass-get-nocache, -nginx-cache-use-stale-5xx, -nginx-cache-use-stale-4xx, -nginx-cache-use-stale-updating.

Server cloning settings

  • (*) cloning utility:

    New options: -maintenance.

DMARC spam protection for the incoming mail

  • (*) mailserver utility:

    New commands: --enable-dmarc, --disable-dmarc.

Nginx-only website hosting

System resource usage limits

  • (*) subscription_settings, service_plan utilities:

    New options: -cgroups_cpu_usage, -cgroups_cpu_usage_soft, -cgroups_cpu_period, -cgroups_ram_usage, -cgroups_ram_usage_soft, -cgroups_ram_period, -cgroups_disk_read_usage, -cgroups_disk_read_usage_soft, -cgroups_disk_read_period, -cgroups_disk_write_usage, -cgroups_disk_write_usage_soft, -cgroups_disk_write_period.

Search-engine friendly HTTP 301 redirect from HTTP ro HTTPS

Securing Plesk and Mail server

  • (*) server_pref utility

    New option: -panel-certificate.

  • (*) mailserver utility

    New command --set-certificate.

Securing WebMail with an SSL/TLS certificate

One-time login to Plesk

  • (*) plesk utility

    New command: –login, new option: -relative-url.

Managing Git repositories

  • (+) git utility

Managing Node.js versions

Managing Plesk extensions

  • (*) plesk utility

    New command: ext.

  • (*) extension utility

    New commands: --enable, --disable, --call

Setting permissions for managing Plesk extensions

  • (*) subscription_settings, service_plan, admin, service_plan_addon, client_pref, reseller_plan, reseller_pref utilities:

    New options: -ext_permission_git_manage_git, -ext_permission_ruby_support_management, -ext_permission_ruby_state_management, -ext_permission_ruby_version_management, -ext_permission_nodejs_support_management, -ext_permission_nodejs_state_management, -ext_permission_nodejs_version_management, -ext_permission_wp_toolkit_manage_wordpress_toolkit, -ext_permission_wp_toolkit_manage_security_wordpress_toolkit, -ext_permission_wp_toolkit_manage_cloning, -ext_permission_wp_toolkit_manage_syncing, -ext_permission_wp_toolkit_manage_autoupdates

  • (-) subscription_settings, service_plan, admin, service_plan_addon, client_pref, reseller_plan, reseller_pref utilities:

    Deprecated options: -manage_wordpress_toolkit, -manage_security_wordpress_toolkit

Setting empty document root for a domain, subdomain, or subscription.

Plesk 12.5

Reassignment of databases between subscriptions

  • (*) database utility:

    New command: --assign-to-subscription.

Database user roles and privileges management

  • (*) database utility:

    New options: -user-role, -set-privileges.

PHP handlers management

  • (*) php_handler utility:

    New commands: --enable, --disable, --get-usage.

Listing mail accounts

  • (*) mail utility:

    New command: --list.

Setting an end date for auto-replies

Displaying global server settings

SSL/TLS ciphers and protocols management

  • (*) server_pref utility:

    New options: -ssl-protocols, -ssl-ciphers.

Managing server-wide backup limits

  • (*) server_pref utility:

    New options: -max-backup-files, -keep-local-backup.

Disabling automatic upgrading of extensions

  • (*) server_pref utility:

    New option: -disable-upgrade-extensions.

Enabling and disabling Fail2ban

  • (*) ip_ban utility:

    New commands: --enable, --disable.

Retrieving new license keys from KA

  • (*) license utility:

    New command: --retrieve.

Managing Plesk locales

Installing and upgrading extensions via URL

  • (*) extension utility:

    New command: --install-url.

Apache MPM mode management

Setting PHP-FPM in service plan setting

  • (*) service_plan utility:

    New option: -php_served_by_nginx.

Security status of WordPress installations

  • (*) wp_instance utility:

    New command: --get-security-status.

Enabling password protection fro site preview

  • (*) server_pref utility

    New options: -preview-protection

Plesk 12.0

WordPress toolkit

  • (+) wp_instance utility.

  • (*) php_handler utility:

    New option: -clipath.

IP address banning (Fail2Ban)

Web application firewall (ModSecurity)

  • (*) subscription utility:

    New commands: --update-web-app-firewall, --show-web-app-firewall.

    New option: -waf-rule-engine.

  • (*) server_pref utility:

    New commands: --update-web-app-firewall, --show-web-app-firewall.

    New options: -waf-rule-engine, -waf-rule-set.

Outgoing mail control

  • (*) mailserver utility:

    New commands: --enable-outgoing-antispam, --disable-outgoing-antispam, --set-outgoing-messages-mbox-limit, --set-outgoing-messages-domain-limit, --set-outgoing-messages-subscription-limit, --set-outgoing-messages-enable-sendmail, --set-outgoing- messages-report-period, --set-outgoing-messages-notification-period.

    New option: -spf-ignore-dns-error.

  • (*) service_plan and subscription_settings utilities:

    New options: -outgoing-messages-mbox-limit, -outgoing-messages-domain-limit, -outgoing-messages-subscription-limit, -outgoing-messages-enable-sendmail.

  • (*) mail utility:

    New option: -outgoing-messages-mbox-limit.

  • (*) site utility:

    New option: -outgoing-messages-domain-limit.

IP addresses to send mail from

  • (*) mailserver utility:

    New command: --set-outgoing-email-mode.

    New options: -explicit-ipv4, -explicit-ipv6.

Prohibited domain names

Access control lists for MySQL database users

  • (*) subscription_settings utility:

    New option: -remote_db_connection.

  • (*) database utility:

    New option: -set-acl, -add-access, -remove-access.

Remote access for PostgreSQL database users

  • (*) database utility:

    New option: -allow-access-from.

Automated migration and transfer of a large number of objects

  • (+) migrate utility.

Converting reseller accounts to customer accounts

  • (*) reseller utility:

    New command: --convert-to-customer.

Moving customer accounts to another owner

  • (*) customer utility:

    New command: --change-owner.

Converting customer accounts to reseller accounts

  • (*) customer utility:

    New command: --convert-to-reseller.

Custom descriptions of Plesk objects

  • (*) reseller, customer, and mail utilities:

    New option: -description.

  • (*) site utility:

    New options: -description, -admin-description.

  • (*) subscription utility:

    New options: -description, -reseller-description, -admin-description.

Preventing customers from using a Plesk server as an FTP storage for Plesk backups

  • (*) server_pref utility:

    New command: --allow-local-ftp-backup.

Database users’ access to databases

  • (*) database utility:

    New options: -database, -any-database.

Clearance of APS applications cache

  • (*) aps utility:

    New command: --clear-cache.

Restoring selected objects from a backup

  • (*) pleskrestore utility:

    New options: -only-mailnames, -only-databases, -only-web-content, -only-sites, -domain-name.

Plesk 11.5

Custom web server settings for websites

  • (*) subscription utility:

    New command: --update-web-server-settings.

    New options: -apache-mime-types, -apache-handlers, -ip-deny, -ip-allow, -apache-directory-index, -nginx-transparent-mode, -nginx-serve-static, -nginx-static-extensions, -nginx-serve-php.

Status of websites in suspended subscriptions

External SMTP server for Plesk notifications and outgoing mail generated by scripts

  • (*) mailserver utility:

    New command: --update-smtp-settings.

    New options: -smtp-host, -smtp-port, -smtp-login, -smtp-password, -mail-notifications, -smtp-tls, -smtp-allow-users.

APS applications settings

  • (*) aps utility:

    New options: -db-server, -prefix, -aps-force-updates.

Restricting the list of applications available for installation

  • (*) customer utility:

    New commands: --add-aps-filter-item, --remove-aps-filter-item, --enable-aps-filter, --disable-aps-filter, --show-aps-filter-info.

    New options: -aps-filter-item-name, -aps-filter-item-value.

  • (*) serice_plan_addon utility:

    New commands: --add-aps-filter-item, --remove-aps-filter-item, --show-aps-filter-info.

    New options: -aps-filter-item-name, -aps-filter-item-value.

Search engine friendly redirection and forwarding

Multiple PHP versions

Custom PHP handlers

Mail autoresponder settings

Plesk Administrator account settings

  • (*) admin utility:

    New commands: --set-admin-password, --set-password.

    New options: -passwd, -encrypted-password, -plain-password, -remote_access_interface, -manage_server_mailgate, -manage_secure_passwords.

Additional Administrator accounts

One database user to access all databases

  • (*) database utility:

    New commands: --create-dbuser, --update-dbuser, --remove-dbuser.

The default database server

Creating additional users while creating mail accounts

  • (*) mail utility:

    New option: -cp-access.

Specifying mail accounts and instant messengers for additional users

  • (*) user utility:

    New options: -email, -external-email, -im-type, -im.

Plesk UI appearance and branding

  • (*) branding_theme utility:

    New commands: --set, --list.

    New option: -name.

  • (*) panel_gui utility:

    New options: ---billing_enabled.

Websites maintenance mode

  • (*) subscription, site, subdomain utilities:

    Deprecated option: -maintenance-mode. The Suspended website status is used instead (see the next change).

The Suspended status of websites

Loading Plesk settings from Partner Central

  • (*) server_pref utility:

    New command: --load-customizations.

Server-wide Plesk settings

  • (*) server_pref utility:

    New options: -aps-force-updates, -aps-suggest-updates, -apache-pipelog, -forbid-ftp-user-rename, -forbid-subscription-rename, -ftp-over-ssl, -autoupdates-third-party.

Server cloning settings

  • (*) cloning utility:

    New options: --reset-init-conf, -skip-update.

Access to Control Panel for resellers

Making copies of service plans, add-on plans, and reseller plans

Domains and domain aliases settings

Displaying customers and subscriptions in a list

Plesk 11.0

Installing the Plesk license key with an activation code

  • (*) license utility: The --install command now accepts activation codes.

Managing Plesk extensions

Improved Plesk security

  • (*) server_pref utility. New option: -min_password_strength.

Cloning Plesk in virtual environments

Custom buttons improvements

  • (*) custombutton utility: New parameters for the -place option: admin-settings, reseller-settings. New option: -noframe.
  • (*) custom_plan_items utility: New option: -noframe.

Plesk updates improvements

Subscribing to security notifications from Plesk

  • (*) init_conf utility: New option: -send_tech_announce.

Using license bundles (web app licenses associated with a Plesk license)

Plesk 10.4

Customizable PHP configuration

  • (*) service_plan, service_plan_addon, subscription, subscription_settings, site utilities: New commands: --update-php-settings, --show-php-settings New options: -settings, -additional-settings

Extended overuse options

  • (*) service_plan, subscription_settings, reseller_pref, reseller_plan utilities: The overuse management options of these utilities now support new value: not_suspend_notify

Custom view for administrators

  • (*) poweruser utility: New options: -simple, -lock
  • (*) admin utility: New options for fine adjustment of Custom view.

Restricting users to access only one subscription

  • (*) user utility: New options: -subscription-name, -for-all-subscriptions

Support for wildcard subdomains

  • (*) subdomain utility: The -create command allows to use the asterisk symbol to create wildcard subdomains.

Quick preview of a website

  • (*) server_pref utility: New option: -preview-domain

Manage availability of apps from Storefront

  • (*) server_pref utility: New option: -show-commercial-apps

Allowing Subdomains to Have Own DNS Zones

  • (*) server_pref utility: New option: -subdomain-dns-zone

Updating Business Manager administrator’s profile

  • (+) update-admin utility.

Updating Business Manager company settings

  • (+) update-company utility.

Managing Business Manager database connection

  • (+) billing-db utility.

Migrating a standalone Plesk Billing database to Business Manager

  • (+) migrate-db utility.

Getting Business Manager error information

  • (+) get-error-report utility.

Troubleshooting GUI Integration between Business Manager and connected Plesks

  • (+) integration utility.

Updating Business Manager configuration and online stores locales and appearance

  • (+) cache utility.

Allowing Subdomains to Have Own DNS Zones

  • (*) server_pref utility: New option: -subdomain-dns-zone

Plesk 10.3

File sharing functionality

  • (+) server_filesharing utility.
  • (*) role utility: New option: -publishFilesOnTheWeb

Plesk 10.2

IPv6 support

  • (*) dns and server-dns utilities:

    New option: -aaaa

  • (*) subscription utility: -ip option can be used multiple times to specify a list of IPV4 and IPv6 addresses addresses.

  • (*) reseller_plan utlity:

    New option: -excl_ipv6_num

Server Name Indication (SNI) support

  • (*) domain and subdomain utilities:

    New option: -certificate-name

Note: The following operating systems support SNI: OpenSuSE Linux 11.3 or later, Ubuntu Linux 10.4 or later, Debian Linux 6.0 or later, and RedHat Linux 6.0 or later.For more information on SNI see section Hosting Multiple SSL/TLS Sites on a Single IP Address (Linux Hosting) of Administrator’s Guide.

Encrypting the administrator’s password

  • (*) admin utility:

    New command: --show-password

Plesk 10.1

Ability to customize the list of applications available for installation on websites and add links to additional services (external or integrated with Plesk as extensions)

  • (+) subscription utility replaces the domain utility and supports new commands and options.

    New commands: --enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items

    New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name

  • (+) custom_plan_items utility.

  • (*) service_plan utility:

    New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items

    New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name

  • (*) reseller utility:

    New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info

    New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type

  • (*) reseller_plan utility replaces the reseller-template utility and supports the following new commands and options.

    New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info

    New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type

Customization of interface appearance and branding settings

  • (+) branding_theme utility
  • (+) panel_gui utility replaces the interface-template utility and supports the following new options: -domain_registration_url, -domain_management_url, -cert_purchasing_url, -mpc_portal_url

Site maintenance mode

  • (*) subscription utility: new option -maintenance-mode.
  • (*) subdomain utility: new option -maintenance-mode.

Ability to create trial sites in SiteBuilder

  • (*) service_plan utility: new option -upsell_site_builder.

Ability to register an external webmail service with Plesk and use it in hosting plans

  • (*) mailserver utility:

    New commands: --add-external-webmail, --update-external-webmail, --remove-external-webmail.

    New options: -webmail-name, -webmail-url, -webmail-status.

Ability to hide mail management functions from Control Panel

  • (*) server_pref utility: new option -disable-mail-ui.

Ability to set the default shell for execution of scheduled tasks through cron

  • (*) server_pref utility: new option -crontab-secure-shell.

Utilities were renamed to better suit the new hosting model

  • The client utility was replaced with the customer utility.
  • The domain utility was replaced with the subscription and site utilities.
  • The domain_prefs utility was replaced with the subscription_settings utility.
  • The domain_template utility was replaced with the service_plan utility.
  • The interface_template utility was replaced with the panel_gui utility.
  • The reseller-template utility was replaced with the reseller_plan utility.
  • The domain_addon_service_plan utility was replaced with the service_plan_addon utility.

Plesk 10.0

Changes in the hosting model and hierarchy of user accounts

  • (-) client_template utility.

  • (*) client utility: the commands --convert-to-reseller and --change-owner are no longer supported; the options -template, -sb-user, -status, and -force are no longer supported.

  • (*) client_pref utility: the command --set-iis-app-pool-settings and options -iis-app-pool-turned-on, -cpu-usage-state, -cpu-usage-value were added; the options -manage dashboard, -max-mg, -desktop-preset, -max_redir, -max_resp, -lock-screen, -desktop-preset are no longer supported.

  • (-) domadmin utility.

  • (-) domuser utility.

  • (*) domain utility: the commands --webspace-status, --lock-subscription, --unlock-subscription, --no-subscription, --switch-subscription, --sync-subscription, --add-subscription, --remove-subscription were added; the options -service-plan, -force-lock, -www-root, -webspace-name, -vendor were added.

  • (+) domain_addon_service_plan utility.

  • (*) domain_pref utility. The following options were removed: -max_redir, -max_mg, -max_resp.

    The following options were added: -max_site, -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -create_domains, -manage_phosting, -manage_php_safe_mode, -manage_performance, -manage_sh_access, -manage_quota, -manage_subdomains, -manage_domain_aliases, -manage_log, -manage_anonftp, -manage_subftp, -manage_crontab, -manage_dns, -manage_webapps, -manage_maillists, -manage_spamfilter, -manage_virusfilter, -manage_webstat, -select_db_server, -allow_local_backups, -allow_ftp_backups, -access_appcatalog, -allow_insecure_sites.

    The option -overuse can now take the new parameter not_suspend.

  • (+) domain_service_plan utility is intended to replace the utility domain_template.

    In addition to the options previously supported by the domain_template utility, the following new options are now supported: -max_site, -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -create_domains, -manage_phosting, -manage_php_safe_mode, -manage_performance, -manage_sh_access, -manage_quota, -manage_subdomains, -manage_domain_aliases, -manage_log, -manage_anonftp, -manage_subftp, -manage_crontab, -manage_dns, -manage_webapps, -manage_maillists, -manage_spamfilter, -manage_virusfilter, -manage_webstat, -select_db_server, -allow_local_backups, -allow_ftp_backups, -access_appcatalog, -allow_insecure_sites.

    The option -overuse can now take the new parameter not_suspend.

  • (*) ip_pool utility: It now supports only operations on IP addresses assigned to resellers; customers are assigned IP addresses in a different manner, only when hosting subscriptions are created for them.

  • (*) mail utility - the following options were removed: -cp-access, -multiple-sessions, -locale, -lines-per-page, -max-button-length, -skin, -lock-screen. The option -forwarding-addresses was added.

  • (*) reseller utility. The following commands are now supported: --lock-subscription, --unlock-subscription, --no-subscription, --switch-subscription, --sync-subscription.

    The following new options are now supported: -service-plan, -force-lock.

    The following commands and options are no longer supported: --convert-to-client, -sb-user, -template.

  • (*) reseller_pref utility. The following new options are now supported: -access_appcatalog, -allow_insecure_sites, -max_site_builder, -max_subftp_users, -max_unity_mobile_sites.

    The following options are no longer supported: -manage_dashboard, -dashboard, -stdgui, -expiration, -max-redir, -max-mg, -max-resp.

  • (+) reseller_service_plan utility is intended to replace the utility reseller_template.

    In addition to the options previously supported by the reseller_template utility, the following new options are now supported: -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -allow_insecure_sites.

    The option -overuse can now take the new parameter not_suspend.

    The following options are no longer supported: -manage_dashboard, -dashboard, -stdgui, -expiration.

  • (+) role utility.

  • (+) user utility.

  • (*) subdomain utility: the new option -www-root is now supported; the following options are no longer supported: -ftp_user, -hard_quota, -sb_publish, -hst_type.

VPS-optimized mode

  • (+) vps_optimized utility.

Power User interface

  • (+) poweruser utility.

User interface customization

  • (*) interface_template utility: the options -hide_disabled, -hide_unavailable_limits, -hide_unavailable_permissions are no longer supported.

Additional FTP accounts

  • (+) ftpsubaccount utility
  • (+) client_pref utility: -max-subftp-users option
  • (+) client_pref utility: -manage_subftp option
  • (+) domadmin utility: -manage_subftp option
  • (+) domain_pref utility: -max-subftp-users option
  • (+) domain_template utility: -max-subftp-users option
  • (+) reseller_pref utility: -max-subftp-users option
  • (+) reseller_pref utility: -manage_subftp option
  • (+) reseller_template utility: -max-subftp-users option
  • (+) reseller_template utility: -manage_subftp option

Changes in Application Catalog

  • (-) aps_catalog utility
  • (+) aps utility

Changes in settings of mail services

  • (*) autoresponder utility: the commands --create, --remove, --attachments, --on, --off are no longer supported; the options -requires, -replyto, -frq, -store, - redirect, -files are no longer supported.
  • (*) domain_pref utility - the following options were removed: -max_redir, -max_mg, -max_resp.
  • (+) spamassassin utility: new parameter -action move.

E-mail notification about system events

  • (+) notification utility.

Plesk 9.5

(+) new options related to integration with Google Services for Websites were added to the admin, reseller, client, and server_pref utilities.

Plesk 9.2

Greylisting

(+) grey_listing utility

Plesk 9.0

APS Catalog

  • (+) aps-catalog utility

Plesk resellers

  • (+) client utility: --change-owner command
  • (+) client utility: --convert-to-reseller command
  • (+) client utility: -owner option
  • (-) client_pref utility: -ip_pool option
  • (+) client_pref utility: -overuse option
  • (*) domain utility: --change-owner command
  • (-) domain utility: -clogin option
  • (*) domain utility: --create command
  • (+) domain_pref: -overuse option
  • (+) ip_pool utility
  • (+) reseller utility
  • (+) reseller_pref utility
  • (+) reseller_template utility

New utilities

  • (+) event_handler utility
  • (+) keyinfo utility

Updates of existing utilities:

  • (-) client_pref utility: -ip_pool option
  • (+) custombutton utility: --list command
  •  (*) domain_template utility
    • (-) -fp option
    • (-) -fp_ssl option
    • (-) -fpauth option
  •  (*) domain utility
    • (-) -fplogin option
    • (-) -fppasswd option

Plesk 8.6

Permission to choose a database server for a database

  • (+) client_pref utility: -select_db_server option
  • (+) client_template utility: -select-db-server option
  • (+) domadmin utility: -select_db_server option

Plesk 8.4

DomainKeys support

  • (+) domain_pref utility: -sign_outgoing_mail option
  • (+) mailserver utility: --sign-outgoing-mail command
  • (+) mailserver utility: --verify-incoming-mail command

Permission to create DNS subzones in DNS superzones owned by other Plesk users

  • (+) server_pref utility: -forbid-create-dns-subzone option

Plesk 8.3

Limit on maximum number of available connections

  • (+) domain utility: -max-connections option

Opportunity to publish sites with Sitebuilder

  • (+) domain utility: -publish-sb-site option

Limit on network use

  • (+) domain utility: -traffic-bandwidth option

The <webuser_name>@<domain_name> format of access to Plesk

  • (-) domain_pref utility: -at-access option

SSO service

  • (+) sso utility

Site applications and site application licenses management

  • (-) siteapp utility: --add-to-vault command

    Use siteapp-item utility instead.

  • (-) siteapp utility: -release option

    Use -sapp-release option instead.

  • (-) siteapp utility: -sapp option

    Use -sapp-name option instead.

  • (-) siteapp utility: -version option

    Use -sapp-version option instead.

  • (+) siteapp utility: -sapp-name option

  • (+) siteapp utility: -sapp-release option

  • (+) siteapp utility: -sapp-version option

  • (+) siteapp-item utility

  • (+) siteapp-license utility