Panel.ini Configuration File

Certain aspects of the behavior of both Plesk and various Plesk extensions cannot be managed via the GUI, XML API, or the command line. Instead, they are governed by entries in the panel.ini configuration file. For example, by editing this file, you can:

  • Forbid logging in to Plesk using 'root' or 'Administrator' credentials.
  • Hide an IP address registered in Plesk, so that it does not appear in the interface and cannot be assigned to subscriptions or resellers.
  • Specify a custom URL for the Extensions Catalog, and so on.

The panel.ini file can be found here:

  • (Plesk for Linux) /usr/local/psa/admin/conf/panel.ini
  • (Plesk for Windows) %plesk_dir%\admin\conf\panel.ini

If the file is missing on your server, create an empty file at the specified location and name it panel.ini. You can also rename the panel.ini.sample file found in the same directory to panel.ini. This way, the file will contain a number of pre-configured settings you can use for reference.

Next in this section:

Configuring Settings in panel.ini

Restoring the Default Settings

Reference

 

Configuring Settings in panel.ini

To configure settings via the panel.ini file, you need to edit it in either of the two ways:

Regardless of the option you choose, to configure one or more settings via the panel.ini file, you need to add entries to it according to the following pattern:

[Section name]
Setting name = Value

Note: If a setting accepts a boolean ('yes' or 'no') value, you can use either 'true', 'on', or 'yes' to enable it, and 'false', 'off', 'no', or 'none' to disable it.

Changes take effect immediately after saving the file. There is no need to restart any services.

For example, to disable IP Address Banning (Fail2Ban), add the following lines to the panel.ini file:

[fail2ban]
enabled = false

As a result, IP Address Banning (Fail2Ban) disappears from the Security group on the Tools & Settings screen, and you can no longer manage it via CLI commands.

Every setting that can be configured via the panel.ini file belongs to a pre-defined section. To customize a setting, you must place it in the panel.ini file within the section to which it belongs. Do not include any individual section more than once. If you want to customize multiple settings belonging to a single section, include it once and place all settings you want to customize within it.

For example, to customize the URL for the application catalog and to enable application catalog customization, add the following lines to the panel.ini file:

[aps]
catalogUrl = "http://catalog.pp.plesk.ru"
catalogsCustomization = on

To configure settings via the Panel.ini Editor extension, go to Extensions > My Extensions > Panel.ini Editor > Go To Extension.

Here, on the "Viewer" tab, you can see the complete list of all settings that can be managed via the panel.ini file, broken down by section. The "Setting" column displays the machine-readable parameter name, and the "Value" column displays its currently assigned value.

Parameters that have been added to the panel.ini file are shown in bold. For parameters whose value has been customized, the default value is displayed in parentheses next to the currently assigned one. For example, on the screenshot above, the parameter "catalogUrl" has been assigned the value "http://apps.example.com" instead of the default one ("http://apps.plesk.com").

To search for a specific parameter, click the button to open the search menu.

To edit the panel.ini file, go to the "Editor" tab and add entries to it, as described above.

 

Restoring the Default Settings

To restore a setting customized via the panel.ini file to its default value, open the file for editing and either remove the corresponding line or comment it out by adding the ';' character at the beginning of the line, like this:

[fail2ban]
; enabled = false

The setting reverts to the default value immediately after saving the file.

To restore all settings customized via the panel.ini file to their default values, do one of the following:

  • Log in to the server via SSH or RDP and remove or rename the panel.ini file.
  • Open the Panel.ini Editor extension and click Reset to defaults.
 

Reference

Here are some customization user scenarios that can be implemented via the panel.ini file. Note that the list is not exhaustive. The behavior of certain Plesk extensions can be customized via the panel.ini file - refer to the extensions' documentation for details.

 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.