- Plesk Onyx for Linux
Plesk pre-upgrade checker shows a warning:
CONFIG_TEXT: [INFO] STEP 28: Checking for custom web server configuration templates...
[WARNING] There are custom web server configuration templates at /usr/local/psa/admin/conf/templates/custom. These custom templates might be incompatible with a new Plesk version, and this might lead to failure to generate web server configuration files. Please check https://support.plesk.com/hc/en-us/articles/213399669 for details.
[INFO] Result: WARNING
CONFIG_TEXT: Custom web server templates that may break web server reconfiguration were moved from /usr/local/psa/admin/conf/templates/custom/ to /usr/local/psa/admin/conf/templates/custom_templates_before_17.0_aBoiafPf/
There are custom templates stored in
Depending on the changes that were made in custom templates, an upgrade can be performed safely, or not.
It is recommended to rename
directory and perform the upgrade.
Note: During the upgrade to Plesk Onyx custom templates directory is renamed automatically, however, it does not happen when upgrading to Obsidian as the directory is kept
Connect to the server over SSH.
Review updated default templates in /usr/local/psa/admin/conf/templates/default, make appropriate changes to custom templates in renamed directory.
Rename direcory of custom templates:
# mv /usr/local/psa/admin/conf/templates/custom_templates_before_17.0_xxxxxx/ /usr/local/psa/admin/conf/templates/custom/
More information about custom templates can be found in Plesk documentation:
To run pre-upgrade checker, download the script from
where is the version of upgraded Plesk.
For example, to check upgrade to Plesk Onyx 17.8.11, the link would be:
# wget http://autoinstall.plesk.com/PSA_17.8.11/examiners/panel_preupgrade_checker.php
Run the script:
# php -d safe_mode=Off panel_preupgrade_checker.php