The install_plugin Script
Valid for versions 100 through the latest version
Version:
100
Last modified: July 28, 2022
Looking for this interface?
Your hosting provider can enable or disable this interface for resellers in WHM's Edit Reseller Nameservers and Privileges interface (WHM >> Home >> Resellers >> Edit Reseller Nameservers and Privileges).
Overview
The /usr/local/cpanel/scripts/install_plugin
script installs a cPanel plugin to a cPanel theme. When you run this script, it uses the archive file’s install.json
file to install a plugin to the dynamicui.conf
file. The cPanel Home interface uses the dynamicui.conf
file to display icons and groups.
To uninstall a plugin, use the /usr/local/cpanel/scripts/uninstall_plugin
script.
- Only the
root
user can run this script. - If the plugin installation file does not contain a
install.json
file, the installation process will fail. - This script does not extract the plugin from the archive file.
Run the script
To run this script on the command line, use the following format:
/usr/local/cpanel/scripts/install_plugin /filepath [options]
Options
Use the following options with this script:
Option | Description | Example |
---|---|---|
filepath |
Required. The cPanel plugin’s installation archive file. The file must be one of the following formats:
|
/path/to/plugin.tar.gz |
--theme |
The cPanel theme to install the plugin to. This option defaults to the jupiter theme. |
--theme=jupiter |