Login/Register
Support

Installatron Plugin Administration Portal


Administration

Documentation for installing, upgrading, transferring, and uninstalling Installatron Plugin.

◎ Install
◎ Upgrade
◎ transfer
◎ Uninstall

Licenses

Documentation involving Installatron Plugin licenses.

◎ WAN/LAN licensing
◎ Renew a license
◎ Edit license

Glossary

  • Installatron Plugin

    1. noun: The action of using Installatron to install an application, to create a new website.

    (see: Installatron Plugin)

  • Installatron Server

    1. noun: The standalone version of Installatron that administrators can hook into their own webhosting systems. (note: previously known as Installatron Servers)

    (see: Installatron Server)

  • Key

    1. noun: Installatron Server uses "a key" to track ownership. (Note that Installatron Plugin does not use a key, it instead uses a license.)

    (see: Installatron Server key)

  • License

    1. noun: Installatron Plugin uses "licenses" to track ownership. (Note that Installatron Server does not use a license, it instead uses a key.)

    2. noun: Some of the applications installed by Installatron also have an optional "pro" version which uses a license.

    (see: Installatron Plugin license)

Download and Install Installatron Plugin

Installatron Plugin is installed as a plugin on supported web hosting control panel systems. To download and install Installatron Plugin, select the control panel that is installed on your server:

cPanel
WHM

DirectAdmin

Plesk
Linux/Unix

Plesk
Windows

Webmin
Virtualmin
beta

Download and Install: cPanel/WHM

To download and install Installatron Plugin on a cPanel/WHM server;

Installation

Execute the below commands from the CLI root command prompt. Select RPM for servers that support the RPM packaging standard, Debian for servers that support the Debian packaging standard, or select Standard for any type of server.

wget https://data.installatron.com/installatron-plugin-cpanel_latest_all.deb
dpkg -i installatron-plugin-cpanel_latest_all.deb

If you experience any errors, see troubleshooting.

Tip: Installing Installatron Plugin without a license will limit use to one domain but is otherwise fully functionally. The server can be upgraded to unlimited domains by purchasing a license -- no further action is required.

Get started

Installatron Plugin is now ready to use in cPanel and WHM.

The main WHM account will see an Installatron Admin button in the Addons portion of the side menu.

Resellers will see an Installatron Admin button in WHM and an Installatron button in cPanel.

Website owners will see an Installatron Applications Installer button in cPanel.

Import existing installations

Existing installations can be imported into the Installatron Plugin system using the one-click tool at Installatron administration > Tools > Converter or this shell command:

/usr/local/installatron/installatron --convert

Maintenance

A crontab process has been created to automate Installatron Plugin maintenance, including checking for Installatron Plugin and application updates.

See Administrator Tutorials for advanced usage.

Download and Install: DirectAdmin

To download and install Installatron Plugin on a DirectAdmin server;

Installation

Execute the below commands from the CLI root command prompt. Select RPM for servers that support the RPM packaging standard, Debian for servers that support the Debian packaging standard, or select Standard for any type of server.

wget https://data.installatron.com/installatron-plugin-directadmin_latest_all.deb
dpkg -i installatron-plugin-directadmin_latest_all.deb

If you experience any errors, see troubleshooting.

Tip: Installing Installatron Plugin without a license will limit use to one domain but is otherwise fully functionally. The server can be upgraded to unlimited domains by purchasing a license -- no further action is required.

Get started

Installatron Plugin is now ready to use in DirectAdmin.

The administrative user will see an Installatron Admin button at the 'admin' and 'reseller' levels.

Resellers will see an Installatron Admin button at their 'reseller' level and an Installatron Applications Installer button at the 'user' level.

Website owners will see an Installatron Applications Installer button at the 'user' level.

Import existing installations

Existing installations can be imported into the Installatron Plugin system using the one-click tool at Installatron administration > Tools > Converter or this shell command:

/usr/local/installatron/installatron --convert

Maintenance

A crontab process has been created to automate Installatron Plugin maintenance, including checking for Installatron Plugin and application updates.

See Administrator Tutorials for advanced usage.

Download and Install: Plesk Linux/UNIX/FreeBSD

To download and install Installatron Plugin on a Plesk Linux/UNIX/FreeBSD server;

Installation

Execute the below commands from the CLI root command prompt. Select RPM for servers that support the RPM packaging standard, Debian for servers that support the Debian packaging standard, or select Standard for any type of server.

wget https://data.installatron.com/installatron-plugin-plesk_latest_all.deb
dpkg -i installatron-plugin-plesk_latest_all.deb

If you experience any errors, see troubleshooting.

Tip: Installing Installatron Plugin without a license will limit use to one domain but is otherwise fully functionally. The server can be upgraded to unlimited domains by purchasing a license -- no further action is required.

Get started

Installatron Plugin is now ready to use in Plesk for Linux/UNIX/FreeBSD.

The admin login and reseller logins will find the Installatron Admin button on the main sidebar.

Client logins and domain logins will find an Installatron Applications Installer button on their main dashboard.

Import existing installations

Existing installations can be imported into the Installatron Plugin system using the one-click tool at Installatron administration > Tools > Converter or this shell command:

/usr/local/installatron/installatron --convert

Maintenance

A crontab process has been created to automate Installatron Plugin maintenance, including checking for Installatron Plugin and application updates.

See Administrator Tutorials for advanced usage.

Download and Install: Plesk Windows

To download and install Installatron Plugin on a Plesk Windows server;

Installation

Execute the below commands with Windows Administrative privileges.

cd "%plesk_dir%\tmp"
mklink /D "%plesk_dir%/Additional/PleskPHP5" PleskPHP74
curl -O https://data.installatron.com/installatron-plugin-plesk-9.1.58-1.zip
plesk bin extension -i "%plesk_dir%\tmp\installatron-plugin-plesk-9.1.58-1.zip"
curl -O https://data.installatron.com/installatron-plugin.exe
installatron-plugin.exe /S

It will take a few minutes for Installatron to show up inside Plesk as numerous files are downloaded in the background.

If you experience any errors, see troubleshooting.

Get started

Installatron Plugin is now ready to use in Plesk for Linux/UNIX/FreeBSD.

The admin login and reseller logins will find the Installatron Admin button on the main sidebar.

Client logins and domain logins will find an Installatron Applications Installer button on their main dashboard.

Import existing installations

Existing installations can be imported into the Installatron Plugin system using the one-click tool at Installatron administration > Tools > Converter or this shell command:

/usr/local/installatron/installatron --convert

Maintenance

A crontab process has been created to automate Installatron Plugin maintenance, including checking for Installatron Plugin and application updates.

See Administrator Tutorials for advanced usage.

Download and Install: Webmin/Virtualmin

To download and install Installatron Plugin on a Webmin/Virtualmin server;

Installation

Execute the below commands from the CLI root command prompt. Select RPM for servers that support the RPM packaging standard, Debian for servers that support the Debian packaging standard, or select Standard for any type of server.

wget https://data.installatron.com/installatron-plugin-virtualmin_latest_all.deb
dpkg -i installatron-plugin-virtualmin_latest_all.deb

If you experience any errors, see troubleshooting.

Tip: Installing Installatron Plugin without a license will limit use to one domain but is otherwise fully functionally. The server can be upgraded to unlimited domains by purchasing a license -- no further action is required.

Get started

Next, ensure "Installatron Applications Installer" is checked under the "Available Webmin modules" section for the "root" user (at Webmin > Webmin Users).

Installatron Plugin is now ready to use in Webmin/Virtualmin.

Import existing installations

Existing installations can be imported into the Installatron Plugin system using the one-click tool at Installatron administration > Tools > Converter or this shell command:

/usr/local/installatron/installatron --convert

Maintenance

A crontab process has been created to automate Installatron Plugin maintenance, including checking for Installatron Plugin and application updates.

See Administrator Tutorials for advanced usage.

How to upgrade Installatron Plugin

Installatron automatically adds a Crontab or Windows Task Scheduler process to upgrade/update once per day. This automatic process can be disabled and re-enabled through Installatron's administration page.

To force an upgrade/update you can either:

1. Select the appropriate tab from these options and follow the instructions therein:

Run these commands as root (DON'T RUN THESE COMMANDS IF YOU ARE USING INSTALLATRON SERVER!):
		
		curl -O https://data.installatron.com/installatron-plugin.sh
		chmod +x installatron-plugin.sh
		./installatron-plugin.sh -f --quick

Tip: To run update in interactive mode, remove -f from the last command.

To perform an update on Installatron Plugin Windows, follow
		the same setups used to install Installatron Plugin.
		See: https://installatron.com/docs/plugin/install/installatron-plugin-plesk-windows
Run these commands as root (DON'T RUN THESE COMMANDS IF YOU ARE USING INSTALLATRON PLUGIN!):
		
		curl -O https://data.installatron.com/installatron-server.sh
		chmod +x installatron-server.sh
		./installatron-server.sh -f --quick

Tip: To run update in interactive mode, remove -f from the last command.

To perform an update on Installatron Server Windows, re-run the installatron-server.exe wizard.

Or, alternatively:

1. Open the "Administration" tab.


2. Click "Installatron" in the Administration section of the sidebar.


3. Click
run Installatron Update/Repair
.

How to transfer Installatron Plugin to another server

To transfer Installatron Plugin to another server and retain all existing installed applications, backups, and administrative settings:

  1. Ensure that you have the latest version of Installatron Plugin installed on the new server.
  2. Disable Installatron Plugin on the old server (in Administration > General).
  3. Transfer the control panel user accounts to the new server. Make sure the ".appdata" and "application_backups" directories are included in the account transfer.
  4. Use your account page to change the assignment on the license to the new server.
  5. Install Installatron on the new server.
  6. To reinstate administrative settings: After Installatron Plugin is installed on the new server, copy these files and directories from the old server to the new server. Note that depending on the control panel software used some of these files may not exist.

    /usr/local/installatron/etc/settings.ini
/root/.appdata/
/home/admin/.appdata/
/var/installatron/data/admin/
  7. Finally, execute these commands as root to rebuild caches on the new server: 
    /usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

Uninstall: Installatron Plugin cPanel/WHM

To uninstall Installatron Plugin from a cPanel/WHM server run the following from CLI as root:

Remove RPM package (if applicable):

rpm -e installatron-plugin-cpanel

Remove Debian package (if applicable):

dpkg -r installatron-plugin-cpanel

Remove from the GUI:

rm -fr /usr/local/cpanel/3rdparty/installatron
rm -f /usr/local/cpanel/whostmgr/addonfeatures/installatron
rm -f /usr/local/cpanel/whostmgr/addonfeatures/itwidget
rm -f /usr/local/cpanel/whostmgr/docroot/cgi/addon_installatron.cgi
rm -f /usr/local/cpanel/base/frontend/*/dynamicui/dynamicui_installatron.conf
rm -f /usr/local/cpanel/base/frontend/*/dynamicui/dynamicui_itwidget.conf
perl -pi -e 's/_in.+\s*//g' /root/cpanelbranding/*/dynamicui.conf
perl -pi -e 's/_in.+\s*//g' /home/*/cpanelbranding/*/dynamicui.conf
/usr/local/cpanel/bin/unregister_appconfig installatron_cpanel
/usr/local/cpanel/bin/unregister_appconfig installatron_whostmgr

Delete the core:

rm -fr /usr/local/installatron
rm -fr /var/installatron
rm -f /etc/cron.d/installatron

Delete user install data (be careful!):

rm -fr /home/*/.appdata
rm -fr /root/.appdata

Uninstall: Installatron Plugin DirectAdmin

To uninstall Installatron Plugin from a DirectAdmin server run the following from CLI as root:

Remove RPM package (if applicable):

rpm -e installatron-plugin-directadmin

Remove Debian package (if applicable):

dpkg -r installatron-plugin-directadmin

Remove from the GUI:

rm -fr /usr/local/directadmin/plugins/installatron

Delete the core:

rm -fr /usr/local/installatron
rm -fr /var/installatron
rm -f /etc/cron.d/installatron

Delete user install data (be careful!):

rm -fr /home/*/.appdata

Uninstall: Installatron Plugin Plesk Linux/FreeBSD/UNIX

To uninstall Installatron Plugin from a Plesk Linux/FreeBSD/UNIX server run the following from CLI as root:

For Plesk Linux/Unix servers, note that the the directories /usr/local/psa and /var/www/htdocs may be different on your server.

Remove RPM package (if applicable):

rpm -e installatron-plugin-plesk

Remove Debian package (if applicable):

dpkg -r installatron-plugin-plesk

Remove from the GUI:

perl -pi -e 's!<itronblock1>.+?</itronblock1>!!' /usr/local/psa/admin/plib/templates/modules.tpl
rm -fr /usr/local/psa/admin/htdocs/modules/installatron

Delete the core:

rm -fr /usr/local/installatron
rm -fr /var/installatron
rm -f /etc/cron.d/installatron

Delete user install data (be careful!):

rm -fr /var/www/htdocs/*/.appdata

Uninstall: Installatron Plugin Plesk Windows

To uninstall Installatron Plugin from a Plesk Windows server run the following from CLI as root:

Remove from the GUI:

rd \"%plesk_dir%\\admin\\htdocs\\modules\\installatron\" /S /Q

Delete the core:

rd \"%itron_dir%\\Data\" /S /Q
rd \"%itron_dir%\\etc\" /S /Q
rd \"%itron_dir%\\lib\" /S /Q
\"%itron_dir%\\uninstall.exe\"

Delete user install data (be careful!):

FOR /D %i IN (\"C:\\inetpub\\vhosts\\*\") DO rd \"%i\\.installaton\" /S /Q

Uninstall: Installatron Plugin Virtualmin/Webmin

To uninstall Installatron Plugin from a Virtualmin/Webmin server run the following from CLI as root:

Remove RPM package (if applicable):

rpm -e installatron-plugin-virtualmin

Remove Debian package (if applicable):

dpkg -r installatron-plugin-virtualmin

Remove from the GUI:

rm -f /usr/libexec/webmin/virtualmin-installatron

Delete the core:

rm -fr /usr/local/installatron
rm -fr /var/installatron
rm -f /etc/cron.d/installatron

Delete user install data (be careful!):

rm -fr /home/*/.appdata

Uninstall: Installatron Plugin cPanel Enkompass

To uninstall Installatron Plugin from a cPanel Enkompass server run the following from CLI as root:


Warning: cPanel Enkompass support is discontinued, both by cPanel and by Installatron, so you will not be able to re-install Installatron Plugin for a cPanel Enkompass server once it is uninstalled.

Delete the core:

rd \"%itron_dir%\\Data\" /S /Q
rd \"%itron_dir%\\etc\" /S /Q
rd \"%itron_dir%\\lib\" /S /Q
\"%itron_dir%\\uninstall.exe\"

Uninstall: Installatron Plugin Kloxo/LxAdmin

To uninstall Installatron Plugin from a Kloxo/LxAdmin server run the following from CLI as root:


Warning: Kloxo/LxAdmin support is discontinued, both by Kloxo and by Installatron, so you will not be able to re-install Installatron Plugin for a Kloxo server once it is uninstalled.

Remove RPM package (if applicable):

rpm -e installatron-plugin-kloxo

Remove Debian package (if applicable):

dpkg -r installatron-plugin-kloxo

Remove from the GUI:

rm -f /usr/local/lxlabs/*/etc/flag/installatron.flg

Delete the core:

rm -fr /usr/local/installatron
rm -fr /var/installatron
rm -f /etc/cron.d/installatron

Delete user install data (be careful!):

rm -fr /home/*/.appdata

How to renew a monthly or annual Installatron Plugin license before it expires

To renew an Installatron Plugin license;

1. Log into Installatron.com

Make sure you're logged into the Installatron.com website and then click "My Account".



2. Click "Manage Licenses" in the Installatron Plugin section.

Installatron Plugin


3. Click the expiration date of the license that you want to renew.

All Licenses (1) Active (1) Expiring (1) Unused (0)
Viewing of 1
ID ACTIVATED RENEWAL TYPE ASSIGNMENT HOSTNAME  
1010101 2001-01-01
2025-09-20		 VPS INTERNAL my.server.net  
 or 

4. Create an invoice.

This page is used to create a license renewal invoice which, once paid, will extend the expiration date of your license.


Tip: Licenses renewed before expiration have the renewal added to the existing expiration. There is no waste when renewing early.

Tip: To renew multiple licenses together: ☑️ select the licenses at step 3 and then change the "WITH SELECTED..." field to "Renew" -- an invoice will be created for renewing all selected licenses.

Tip: To have licenses automatically renew: ☑️ select the licenses at step 3 and then change the "WITH SELECTED..." field to "Turn Auto-Renew ON".

How to change the IP on my Installatron Plugin license

To edit your license(s);

1. Log into Installatron.com

Make sure you're logged into the Installatron.com website and then click "My Account".



2. Click "Manage Licenses' in the Installatron Plugin section.

Installatron Plugin


3. Enter a new IP address the license's "ASSIGNMENT" field.

All Licenses (1) Active (1) Expiring (1) Unused (0)
Viewing of 1
ID ACTIVATED RENEWAL TYPE ASSIGNMENT HOSTNAME  
1010101 2001-01-01 2025-09-20 VPS INTERNAL
my.server.net  
 or 

4. Click the "Save Assignment Changes" button.

All Licenses (1) Active (1) Expiring (1) Unused (0)
Viewing of 1
ID ACTIVATED RENEWAL TYPE ASSIGNMENT HOSTNAME  
1010101 2001-01-01 2025-09-20 VPS INTERNAL my.server.net  
 or 

How to license a server that is routed behind a WAN or LAN intranet

Installatron requires a public IP address for licensing. You can view the IP address that Installatron thinks should be the licensed IP address by installing Installatron, if it's not already installed, or by running this command:

/usr/local/installatron/installatron --refresh-license

In either case, read the output to see the IP address that Installatron thinks should be licensed.

However, you can also see what is likely to be the correct IP address by running one of these commands:

ifconfig
(or)
curl ifconfig.co

And then try this:

echo "BROARDCAST_IP_IN_IFCONFIG" > /usr/local/installatron/mainip
rm -f /usr/local/installatron/etc/license.key
/usr/local/installatron/repair -f --quick

Where FIRST_IP_IN_IFCONFIG is the 'broadcast' IP address that you'll find in the first part of ifconfig's output.

Additionally, make sure that this works:

curl -v https://data.installatron.com/manifest.md5

If that fails then you might simply have a problem with your firewall configuration.

Finally, if you are using Installatron Plugin with the DirectAdmin then read this DirectAdmin FAQ entry: https://www.directadmin.com/lan.shtml

Specifically, if you know the server's correct public outbound IP address then you might be able to solve any problems by adding this:

lan_ip={the_outbound_ip}

To this DirectAdmin configuration file:

/usr/local/directadmin/conf/directadmin.conf
index
© 2004 - 2025 Installatron LLC. All rights reserved. Privacy Policy.