Plesk Repair Utility

The Plesk self-repair functionality enables you to automatically diagnose and resolve issues with Plesk and Plesk services. If you encounter an issue with one of the Plesk services (for example, if mail is not being sent or delivered, or a website fails to open, and so on), or with Plesk itself (for example, if error messages are being displayed in the Plesk interface, or if Plesk pages fail to load), you can use the Plesk repair utility to attempt to resolve it. The utility can be used to check and repair individual aspects of Plesk (such as the mail service, or the Plesk database), or all the aspects at once.

To run the Plesk repair utility, log in to the server via SSH (if you are using Plesk for Linux), or RDP (if you are using Plesk for Windows), and run the plesk repair command, specifying the desired aspect and options:

plesk repair ASPECT [OPTION]

The Plesk repair utility can be run in one of the three modes:

  • Interactive mode. Whenever the utility detects an issue or is about to reconfigure a service, it informs you and prompts you for the permission to attempt to resolve the issue or reconfigure the service. By default, the repair utility runs in the interactive mode. Note that certain operations (such as resolving issues caused by missing PHP handlers) require you to choose from a list of available options, as opposed to simply answering "yes" or "no", and for that reason can only be performed in the interactive mode. Such operations are marked accordingly in the descriptions of the corresponding aspects.
  • Diagnostic mode. The utility informs you about any detected issues, but does not resolve them. To run the repair utility in the diagnostic mode, use the plesk repair command with the -n option.
  • Repair mode. The utility attempts to resolve any issues it detects. It also reconfigures certain services, even if no issues were detected. To run the repair utility in the repair mode, use the plesk repair command with the -y option.

One of the following aspects must be specified (click the name of the aspect to see a detailed explanation, aspect-specific options, and usage examples):

  • all - This aspect includes all the aspects below.
  • mail - This aspect diagnoses and troubleshoots issues with the mail server.
  • web - This aspect diagnoses and troubleshoots issues with the web server.
  • dns - This aspect diagnoses and troubleshoots issues with the DNS server.
  • ftp - This aspect diagnoses and troubleshoots issues with the FTP server.
  • db - This aspect diagnoses and troubleshoots issues with the Plesk database.
  • fs - This aspect diagnoses and troubleshoots issues with the file system.
  • mysql - This aspect diagnoses and troubleshoots issues with MySQL.
  • mssql - This aspect diagnoses and troubleshoots issues with Microsoft SQL Server.
  • installation - This aspect diagnoses and troubleshoots issues with Plesk itself.

Certain operations can provide extended output. To see the extended output, use the plesk repair command with the -v option.

Whenever the utility detects an issue, it classifies it as either WARNING or ERROR, depending on the severity of the issue. By default, the utility returns error code 1 on completion if any ERROR level issues are detected, or error code 0 if all detected issues are of the WARNING level, or if no issues are detected at all. To make the utility return error code 1 if at least one WARNING level issue is detected, use the plesk repair command with the -treat-warnings-as-errors option.

To get help for the plesk repair utility, run the plesk repair command with the help(or the --help)option:

plesk help repair

or

plesk --help repair

To get help for any particular aspect of the utility, run the same command with specifying the aspect:

plesk help repair [ASPECT]

or

plesk --help repair [ASPECT]

For example, the plesk repair help mail command will display help for the mail aspect.

Next in this section:

Plesk Repair Utility: All

Plesk Repair Utility: Mail

Plesk Repair Utility: Web

Plesk Repair Utility: DNS

Plesk Repair Utility: FTP

Plesk Repair Utility: File System

Plesk Repair Utility: Plesk Database

Plesk Repair Utility: File System

Plesk Repair Utility: MySQL

Plesk Repair Utility: Microsoft SQL Server

Plesk Repair Utility: Installation

 

Leave your comments on this page

Leave your feedback or question on this documentation topic below. For technical assistance, contact your hosting service provider or submit a request to Plesk support. Suggest new features for Plesk here. Discuss general questions on the Plesk forum. All offtopic comments will be removed.