The plesk command line utility is used to wrap other Plesk command line utilities. Additionally, it provides administrators and developers convenient way to access Plesk database, configuration files, and log files and allows performing other important tasks such as running daily maintenance script and the Plesk installer.

Usage

plesk [command]

Example

The following command creates the additional Administrator account with the contact name John Doe, Plesk login name JDoe, password sample, and account’s email address JDoe@example.com.

plesk bin admin_alias --create JDoe -passwd sample -contact "John Doe" -email JDoe@example.com

Commands

Command Parameter Description Example
bin UTILITY

Runs the specified Plesk command line utility (e.g., customer, database).

This is applicable to public CLI utilities located at the /usr/local/psa/bin directory.

To create the account with the login name JDoe, password sample, and the account’s email address JDoe@example.com:

plesk bin admin_alias --create JDoe -passwd sample -email JDoe@example.com

or

plesk bin admin_alias -c JDoe -passwd sample -email JDoe@example.com

conf CONFNAME Open the specified Plesk configuration file in the editor. The available configuration files are: panel.ini (Plesk internal settings), php.ini (PHP interpreter settings, for Plesk with web interface only).

To open panel.ini file in the editor:

plesk conf panel.ini

daily [TASK_NAME]

Run daily maintenance script.

The following scripts are available:

  • CheckForUpdates
  • InstallUpdates
  • UpdateKeys
  • PleskUsage
  • Sitebuilder
  • MailUsage
  • ExecuteStatistics
  • ProcessAutoreports
  • OptimizeStatistics
  • AnalyseDomainStatistics
  • AnalyseClientStatistics
  • ExecuteSpamtrain
  • LoadCustomizations
  • UpdateApsCache
  • UpdateApsApplications
  • ExecuteGlCleaner
  • StoreProtectedConfigs
  • Filesharing
  • UpgradePanel
  • ExecuteWebStatistics
  • UpdateModSecurityRuleSet
  • AutoresponderEndDate
  • UpdatePhpCurlCertificates
  • ExecuteQuotacheck
  • BackupRestoreStats
  • UpgradeExtensions
  • ComposerSelfUpdate

To run daily check for updates:

plesk daily CheckForUpdates

db [COMMAND | SQL]

Execute database specific command.

Open MySQL console if no particular command was specified.

Run an SQL query if it is provided instead of a command

Additional commands:

  • tables - Show the list of existing database tables
  • dump [databases] - Show a dump of the specified Plesk database(s) (the psa database dump is shown by default)
  • desc <table> - Show a structure of the specified database table
  • show <table> - Show content of the specified database table

Additional options:

db and  db dump commands can be followed by mysql and mysqldump options respectively:

  • [options][COMMAND SQL]
  • [options] > [filename]

To execute a one-time db command with an option and exit MySQL console, put -e option at the end of the desired command:

plesk db[options]-e[COMMAND SQL]

To display the list of existing database tables:

plesk db tables

To create the psa database dump (with the “Turn off extended-insert” option) and save it in /tmp/psa.sql:

plesk db dump psa --skip-extended-insert > /tmp/psa.sql

To produce an XML output of the pname field of the clients table:

plesk db -Xe "SELECT pname FROM clients"

or

plesk db --xml -e "SELECT pname FROM clients"

installer [SHORTCUT | OPTIONS]

Run Plesk installer with given options or a predefined set of options via a shortcut.

Available shortcuts:

  • install-all-updates - Install all available updates within current Plesk version, including updates for system components such as MySQL or PHP.
  • install-panel-updates - Install only Plesk updates. Reinstall patch if the latest update is already installed. System components such asMySQL and PHP will not be updated unless it is required for proper Plesk functioning.

To install all available updates within current Plesk version:

plesk installer install-all-updates

log LOGNAME

Display the specified Plesk log file using the “tail -f” utility.

Available log files:

  • error_log - Plesk errors
  • access_log - Web server access log
  • panel.log - Plesk events log
  • maillog - Mail server log file
  • --all - Monitor all available log files

To display Plesk error log:

plesk log error_log

login [USERNAME][-relative-url]

Generate a one-time login link for the specified user. If no user is specified, the link for Plesk administrator is generated.

If the -relative-url option is used, a relative link will be generated. For example: /login?secret=rPAGKviCu1mA3PyUUR3q821UrjNpCpY6ic8ShrnYz90%3D

To use this link for logging in to Plesk, add it to the Plesk server URL based on the host name or the IP address.

Otherwise, a pair of absolute links based on the the Plesk server host name and the IP address are generated. For example:

https://example.plesk.com:8443/login?secret=9JEDkzvRkRfg%2BuzwHNW3lMk7RABrckhTVmetVY2o%2BBU%3D

https://198.51.100.0:8443/login?secret=9JEDkzvRkRfg%2BuzwHNW3lMk7RABrckhTVmetVY2o%2BBU%3D

The generated links can be used only once and become invalid after 24 hours since the generation time.

To generate a one-time login:

plesk login

To generate a one-time login for the user user_demo:

plesk login user_demo

To generate a one-time relative link for the user user_demo:

plesk login user_demo -relative-url

php FILENAME.php Run a PHP script using the Plesk PHP interpreter.

To run the script.php script from the tmp directory:

plesk php /tmp/script.php

repair ASPECT [OPTION]

Run Plesk check and repair tool.

Provide aspect ‘all’ to check and repair all aspects in the interactive mode.

Available aspects: all, mail, web, dns, ftp, db, mysql, fs, installation.

Available options:

-y - Try to repair all found issues.

-n - Do not repair anything, check only.

-v - Display more detailed output (verbose mode).

For details, refer to Plesk Repair Tool.

To reconfigure the mail settings for all mailboxes belonging to the example.com domain, as well as domain-wide mail settings:

plesk repair mail example.com

sbin UTILITY

Run the specified Plesk internal utility.

This is applicable to the utilities located at /usr/local/psa/admin/sbin directory.

To enable nginx proxy server:

plesk sbin nginxmng -e

version   Show product version information. Version, build date, revision and architecture will be shown.

To view Plesk version information:

plesk version

ext <name><command>[<options>] Calls a command-line interface of the specified extension.

To run the –list command of the git utility available for the Git Manager extension:

plesk ext git --list

help [COMMAND] Show help and exit. If a command name is specified, the help for a particular command is displayed. If no parameters are used, the plesk utility help is displayed.

To view the help for the repair command:

plesk help repair